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Preface 


Required Publications 


Related Publications 


This publication provides installation managers, system programmers, and 
operators with the information required to plan for, install, and use SMF in both 
VS1 and VS2. Information is common to both systems unless specifically indicated 
otherwise. 


This publication has the following major divisions: 


“Introduction,” which introduces SMF records and exits and discusses the 
compatibility of SMF between VS1 and MFT, VS2 and MVT, and VS1 and VSz. It 
also describes the basic SMF functions and the relationship of SMF to the 
operating system and to user written exit routines. 


“Incorporating SMF into the System,” which describes procedures for 
incorporating SMF into an operating system. 


“System Information and Requirements,” which describes storage requirements, 
performance, and operational considerations such as IPL and data management 
procedures. 


“Report Programs,’’ which describes sorting SMF records and designing report 
programs. 


“Exit Routines,’ which describes planning, writing, and testing user written exit 
routines. 


‘“‘Accounting Records,’ which fully describes the accounting records. 

“Data Set Activity Records,’ which fully describes the data set activity records. 
‘“Volume Records,” which fully describes the volume records. 

‘System Use Records,” which fully describes the system use records. 
“Subsystem Records,’”’ which fully describes the subsystem records. 


‘‘Appendix A: Field to Record Cross Reference,” which lists all the fields in 
alphabetic order and gives the record types containing each field. 


“Index,” which is a subject index to this publication. 


The following publications are required for use with the book you are now 
reading: 


OS/VS Message Library: VS1 System Messages, GC38-1001, and OS/VS 
Message Library: VS2-System Messages, GC38-1002, which contain a listing 
and explanation of the messages issued by SMF. 


OS/VSI System Data Areas, SY28-0605, and OS/VS2 System Data Areas, 
SY28-0606, which contain additional information on the contents of SMF 
records. 


The reader should be familiar with the information presented in the following 
publications: 


OS/VS Assembler Programmer’s Guide, GC33-4021, which describes the 
ASMFCL cataloged procedure, which is used to link-edit sample exit routines. 
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OS/VS JCL Reference, GC28-0618, which describes the OUTLIM parameter, 
which is used in conjunction with a user written exit routine. 


OS/VS Data Management Services Guide, GC26-3783, which describes the 
record descriptor word (RDW) used to write records in the SMF data set. 


OS/VS1 System Generation Reference, GC26-3791, and OS/VS2 System 
Generation Reference, GC26-3792, which describe the system generation 
program used to include SMF and associated functions into the operating 
system. 


OS/VS Utilities, GC35-0005, which describes the IEBUPDTE and IEBDG utility 
programs, which are used to enter the SMFDEFLT data set into SYS1.PARMLIB 
and to generate samples of standard parameter lists for exit routines. 


OS/VS1I Job Management Logic, SY24-5161, and OS/VS2 Job 
Management Logic, SY28-0621, which describe the OUTLIM parameter. 


OS/VS1 Storage Estimates, GC24-5094, and OS/VS2 Storage Estimates, 
GC28-0604, which provide information on storage requirements. 


Operator’s Library: OS/VS1 Reference, GC38-0110, and Operator’s Library: 
OS/VS2 Reference, GC38-0210, which describe the HALT command. 


OS/VS Supervisor Services and Macros, GC27-6979, which describes step 
priorities. 
OS/VS Message Library: VSI System Codes, GC38-1003, and OS/VS 


Message Library: VS2 System Codes, GC38-1008 which describe system 
completion codes. 


OS/VS1 RES: System Programmer’s Guide, GC28-6878, which describes 
Remote Entry Services. 


OS/VS1 Planning and Use Guide, GC24-5090, which provides information 
on handling accounting information when SMF=BASIC is specified. 


OS/VS2 HASP II Version 4 Systems Programmer’s Guide, GC27-6992, 
which describes the HASPGEN parameters that relate to SMF and the procedure 
for including the exit IEFUJP into HASP. 


OS/VSI1 Virtual Storage Access Method (VSAM) Logic, GC-26-3817, which 
describes the format of a record in a VSAM data set. 


OS/VS Virtual Storage Access Method (VSAM) Programmer’s Guide, 
GC26-3818, which describes how to calculate the length of vsam catalog 
records. 


For information on the PL/I and Sort/Merge program products, you may refer to 
PL/I Language, SC33-0009 and to Sort/Merge, SM/1, Programmer’s Guide, 
$C33-4007. 


Notation Conventions 


The format of the parameters and instructions shown in this publication is 
governed by the rules of notation discussed below. 


Bold Type 


Information in bold type (NONE, NSL, etc.) must be entered exactly as shown. 
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Italic Type 


Special Characters 


Punctuation 


Braces 


Brackets 


Underscores 


Information in italics (xx, register address, etc.) indicates data to be supplied by 
the user. In the following examples: 


BUF=n 
VOL=SER=vol.ser.no. 


n is replaced by a number and vol.ser.no. is replaced by a volume serial number. 


Special characters are used to indicate alternative items and required blank 
characters. Alternative items are separated by an OR sign (|). No more than one 
of the items separated by OR signs may be selected. In the following example: 


1|2|3 
only one of the values may be selected. 


A required blank character is indicated by 6. In the following example, a blank is 
required between DD and DUMMY: 


DD bDUMMY 


The punctuation used in the commands (commas, semicolons, colons, and 
apostrophes) must be entered as shown. 


Braces { } indicate a choice of entry. You must include one, and only one, entry. 
If there are several choices within braces, you may enter any one of the choices. 
The braces themselves are never entered. In either of the following examples: 


{NO| YES} {NO} 
{YES} 


you must enter either the word NO or the word YES. 


Brackets [ | indicate an optional value. The brackets themselves are never entered. 
In the following example: 


KEYWORD =value [,value2 | 


value2 is optional and need not be entered. 


Underscores indicate the value that is assumed if no value is entered. Values that 
are assumed are called defaults. In the following example: 


[YES | NO] 


if no value is given, YES is assumed. 
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Introduction 


Data Collection 


SMF (System Management Facilities) is a feature of OS/VS that provides the means 
for gathering and recording information that can be used for billing customers or 
evaluating system usage. Information is gathered and recorded by SMF data 
collection routines and by user written exit routines. Because the data collection 
and exit routines are independent of one another, they can be used in combination 
or separately. 


Note: SMF cannot be used for system tasks. In VS2 only, SMF cannot be used for 
problem programs started from the console. 


SMF data collection routines gather several types of information: 
e Accounting information, such as CPU time and device and storage usage. 
e Data set activity information, such as EXCP count and the user of the data set. 


e Volume information, such as the space available on direct access volumes and 
error Statistics for tape volumes. 


e System use information, such as system wait time and I/O configuration. 
e Subsystem information, such as subsystem start and stop time. 


The type of data to be collected can be modified by the operator at each initial 
program loading (IPL). 


Through user written analysis and report routines, this information can be used in 
a variety of ways. For example, this information can be used to prepare customer’s 
bills. The information might also be used to measure system usage against 
departmental standards of efficiency and performance. 


SMF is not, however, confined to after-the-fact analysis. SMF allows you to write 
exit routines that can monitor a job or job step at various points during its 
processing cycle—from control statement analysis to termination of the job. 
Therefore, by adding installation routines at the appropriate exits, standards of 
identification, priority, resource allocation, and maximum execution time can be 
enforced. 


Here’s an example of using both facilities provided by SMF. By using and 
analyzing the information obtained by the data collection routines, the installation 
manager determines the average time each job step uses the CPU. In general, he 
finds that job steps exceeding this time limit are in a loop or unending wait state. 
Time is being wasted and overall efficiency impaired. Therefore, the average is 
used to establish a time limit through an exit routine for each job or job step 
running on the system; a job exceeding the expected time limit will be terminated. 
However, there must be some way to allow a job to exceed the expected time 
limit. Therefore, a routine is coded for the time limit exit. This routine allows the 
operator to extend the run time for selected jobs, such as the inventory program at 
year’s end. 


Various routines within the control program format SMF records and write them to 
the SMF data set. At IPL you can select which of certain groups of SMF formatted 
records are to be recorded through the use of SMF control parameters. (See 
‘Selecting SMF Records Using SMFDEFLT Parameters”’ in the chapter 
“Incorporating SMF into the System.’’) In addition to the records supplied by SMF, 
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Accounting Records 


you can create records to supplement or replace SMF records in the user written 
routines according to your record definitions and formats. (See ““SMFWTM Macro 
Instruction” in the chapter “‘Exit Routines.’’) 


The records can be grouped according to the type of information they contain, as 
follows: 


e Accounting records, which describe for each job and job step (1) who used the 
system, (2) what was used in the system, (3) how much was used, and (4) the 
completion code. These records describe background jobs for both VS1 and vsz. 
They describe foreground jobs for VS2 only. 


« Data set activity records, which describe the characteristics, activity, and user of 
data sets. These records also contain information about the deletion and 
renaming of data sets. 


« Volume records, which describe the space available on direct access volumes 
and contain error statistics for tape volumes, and describe the data spaces that 
are recorded in a VSAM Catalog. 


e System use records, which describe the configuration of the system, give system 
Statistics such as wait time and total paging statistics, describe SMF options in 
effect, and record the occurrence of certain events. 


e Subsystem records, which describe the activities and events of the particular 
subsystem. These records contain information on (1) when the subsystem is 
started and stopped—date and time, (2) subsystem options, and (3) the 
occurrence of certain subsystem events. The records describing RES are 
available only in VS1 and those describing HASP are available only in VS2. 


Accounting records describe how much a job or job step used the system. Some of 
the information contained in these records includes identification fields, accounting 
information from the JOB and EXEC statements, priority, CPU time (the time a job 
or job step actually uses the CPU), SYSIN and SYSOUT usage, device usage, and 
job or job step completion code. This type of information can be used to bill 
customers for use of the system. 


Figure 1 lists the records included in the group of accounting records, describes 
when each record is written, and lists some of the information contained in each 
record. 


See the chapter “‘Accounting Records” for more information on and the complete 
format of each of the accounting records. 


Data Set Activity Records 


Data set activity records describe the characteristics, activity, and user of data sets. 
Some of the information contained in these records includes data set names, 
volume serial numbers, number of volumes, and various control block fields. This 
information can be used by user written routines that report the data sets used by 
each job or job step. 


Figure 2 lists the records included in the group of data set activity records, 
describes when each record is written, and lists some of the information contained 
in each record. 


See the chapter “Data Set Activity Records’ for more information on and the 
complete format of each of the data set activity records. 
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Record Type 





Figure 1. 


After normal or abnormal 
termination of a job step for 
background jobs. 


After normal or abnormal job 
termination for background 
jobs. 


After processing of a SYSOUT 
class or form within a class for 
a background job has finished. 


As a job is purged from the 
system in a VS2 system with 
HASP. 


Each time a LOGOFF function 
processes a step termination for 
a foreground job in a VS2 
system. 


Each time a LOGOFF process 
has been completed for 


foreground jobs in a VS2 system. 


The dynamic allocation function 
processes a de-allocation, 
concatenation, or 
de-concatenation request for 
foreground jobs. 


and the Information They Contain 


When Written Information Contained 


Job identification, time of day that 


‘certain events occur during step 


processing, step CPU time, amount of 
main storage allocated and used, devices 
used, step paging activity, completion 
code, step priority, step accounting data, 
termination indicator. 


Job identification, time of day that 
certain events occur during job 
processing, job CPU time, completion 
code, job priority, job accounting data, 
termination indicator. 


Writer start and end times, number of 
SYSOUT data sets within the class and 
form, number of logical records 
processed. 


Job identification, time of day that 
certain events occur during job 
processing, total amount of SYSOUT 
output for the job, accounting 
information. 


Job step information, such as LOGON 
time, main storage occupancy time, 
number of TGETs and TPUTs issued, job 
step CPU time, completion code, and 
main storage used. (Similar to type 4, 
which is produced for background jobs.) 


Job information, such as LOGON time, 
number of TGETs and TPUTs, session 
completion code, LOGON priority, LOGON 
enqueue time, termination indicator, 
SYSOUT classes for the session, and 
session CPU time. (Similar to type 5, 
which is produced for background jobs.) 


Device class, unit type, channel/unit 
address, and EXCP count. (Record types 
34 and 40, together, can be considered 
the equivalent of record type 4 for 
background jobs.) 
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Introduction 


Record Type When Written Information Contained 


A-user’s data set on a tape or Creation and expiration dates, device 

direct access device that was type, EXCP count, volume serial numbers, 

opened for INPUT or RDBACK is | number of volumes, record format and 

closed or processed by EOV. length, and pertinent portions of system 
control blocks. 


A user’s data set on a tape or Same type as record 14. 
direct access device that was 

opened for OUTPUT, UPDAT, 

INOUT, or OUTIN processing is 

_closed or processed by EOV. 


A user’s data set is scratched. Data set name, number of volumes, 
volume serial numbers. 


A data set is renamed. Old data set name, new data set name, 
number of volumes, volume serial 
numbers. 





Each time a job is initiated. Job identification, programmer's name, 


user identification, number and contents 
of accounting fields on JOB statement. 


At the successful or unsuccessful | The name of the catalog in which the 

opening of a VSAM component. | component or cluster is defined and the 
volumes on which the catalog and the 
component or cluster are stored. 


When a VSAM component or The condition that caused the record to 
cluster is closed, when it be written, identifies the volume on 
becomes necessary to switch to | which the component is stored, extents of 
another volume to continue the component on the volume, and 
processing, or when no more statistics about processing events that 
space is available on a volume. | have occurred since the component was 
One record is written for each opened. 

component closed. If a cluster is 

closed, one record is written for 

each component in the cluster. 





When a cluster or component is | The name of the VSAM catalog in which 
renamed. the component is defined and the old and 
new names. 





Figure 2. Table of Data Set Activity Records Showing When They Are 
Written and the Information They Contain 
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Volume records describe the space available on direct access volumes and give 
error Statistics for tape volumes, and describe data spaces in a VSAM catalog. This 
information can be used by IFHSTATR or by user written routines that address 
problems of volume deterioration (defective tracks) and space fragmentation. (See 
“IFHSTATR” in OS/VS Utilities, GC35-0005.) 


Figure 3 lists the records included in the group of volume records, describes when 
each record is written, and lists some of the information contained in each record. 
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Record Type Information Contained 


For each direct access device on | Number of unused alternate tracks, 

line at IPL and when a HALT or | number of unallocated cylinders and 
SWITCH command is processed, | tracks, number of cylinders and tracks in 
and for any direct access device | the largest free extent, owner 

when it is demounted. identification number. 


When a user data set on Volume serial number, channel/unit 
magnetic tape is closed or address, number of read and write errors. 
processed by End-of-Volume. 





When data space is defined, Information avout the catalog in which 

extended, or deleted. the data space is defined, the volume on 
which it is allocated, the number of free 
data space extents on that volume, and 
the amount of available space. 





Figure 3. Table of Volume Records Showing When They Are Written 
and the Information They Contain 


See the chapter ‘““Volume Records” for more information on and the complete 
format of each of the volume records. 
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System use records describe the system configuration and SMF options in effect, 
give system statistics (such as system wait time and paging statistics), and record 
the occurrence of certain events. Some of the information contained in these 
records includes system identification, SMF options, number of bytes in both 
virtual and real storage, system wait time, paging statistics, and the I/O 
configuration. Some of the SMF events whose occurrences are recorded are the 
beginning and ending of a dump of the SMF data set and the beginning and ending 
of a period of time when data is not being recorded. This type of information can 
be used by user written programs that report system efficiency, performance, and 


usage. 


Figure 4 lists the records included in the group of system use records, describes 
when each record is written, and lists some of the information contained in each 


record. 






At SMF initialization and at the 
first job step termination 
following the expiration of a 
ten-minute interval of elapsed 
system time. 











At the beginning of a dump 
data set. 


= At the end of a dump data set. 


After any period when there 
was no SMF data set available 
for recording. This is the first 
record written when an SMF 
data set again becomes 
available. 




















During system initialization 
after IPL. 





















During processing of the VARY 
ONLINE operator command. 


After a device is added to the 
configuration. 










During processing of HALT or 
SWITCH operator commands. 












At IPL and after each DEFINE 
command is processed under 
VS1 only. 











Record Type When Written Information Contained 
During system initialization Real and virtual storage size and SMF 
after IPL. options in effect. 


CPU wait time, system paging statistics 
accumulated during all of the ten-minute 
intervals that expired since the last type 1 
record was written, the expiration time of 
the last ten-minute interval. 


System identification and the time and 
date the record was moved to the SMF 
buffer. (This record is the standard 
record header.) 









Same type as 2. 


Count of SMF records generated but not 
written and the start and end times of the 
period during which no records were 
written. 


Descriptions of each online device at IPL. 
(Each entry description includes the 

device class, unit type, and channel/unit 
address.) 





Identification of the device added to the 
configuration. 


Identification of the device made 
available by device class, unit type, and 
device address. Job requiring the 
allocation is identified. 


During processing of the VARY | Identification of the device removed from 
OFFLINE operator command. the configuration. 


System wait time and paging statistics 
since the last record type 1 and the time 
this record was built. 







The amount of storage assigned to each 
partition. 


Figure 4. Table of System Use Records Showing When They Are Written 
and the Information They Contain (Part 1 of 2) 
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Subsystem Records 


Record Type When Written Information Contained 


Whenever the time sharing TSO information, such as the time sharing 
option is started with a START initiation procedure name, time sharing 
TS command under VSz2 only. member name in SYS1.PARMLIB, SMF 
foreground options, storage available to 
TSO and background jobs, information 
indicating the characteristics of the time 
sharing task started, and time sharing 
configuration information, such as the 
number of swap devices and a device 
entry for each swap device. 








Whenever the Terminal Input/output control initialization 
Input/Output Controller (TIOC) | information, such as the total number 
initialization routine is entered | and size of time sharing buffers, number 
by the time sharing control of buffers per user, number of buffers 
(TSC) task as the result of a reserved on the free queue, and number 
START TS command under vSs2 of users that constitute slack time. 

only. 





Whenever the driver Guaranteed background execution 
initialization routine is entered | percentage, information about the users 
by the TSC task as the result of || on each subqueue, such as minimum time 
a START TS command under VS2 | slice to be given to a user on the 

only. subqueue. 











Whenever the driver modify Modifications made to the driver. (This 
routine is entered as a result of | information is similar to that contained in 
a modify driver command under | record type 32.) 

VS2 only. 








Each time a MODIFY TS Modifications to TSO. (This information 
command is issued under vs2 is similar to that contained in record type 
only. 30.) 


During the termination of time | Time sharing initiation procedure name 
sharing options and when the and time sharing task identifier. 

TSC abnormally terminates one 

or more time sharing regions 

and none is restarted under vSs2 

only. 





Figure 4. Table of System Use Records Showing When They Are Written 
and the Information They Contain (Part 2 of 2) 


See the chapter ‘‘System Use Records” for more information on and the complete 
format of each of the system use records. 


Record types 43 through 49 are subsystem records. Some information contained in 
these records is common, such as system indicator, subsystem identification, and 
CPU identification. The other information contained in the records is pertinent to 
the record type and the subsystem for which it is written. For example, record 
type 43 (HASP Start), hereafter referred to as 43H, and record type 43 (RTAM 
Start), hereafter referred to as 43R, contain common headings. But unique 
subsystem data, such as HASP options in 43H and the RTAM start procedure in 
43R, is contained in a particular subsystem record. 


Some of the common data contained in these records includes the record type, 
date, time, system identification, and subsystem identification. Some of the events 
whose occurrences are recorded are sign-on and sign-off of a remote user, 
start-line, stop-line, log-on, log-off, log-off modification type, and number of lines 
modified. This information can be used by the user written programs that report 
the activity of the subsystems. 
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Figure 5 lists the records included in the group of subsystem records, describes 
when each record is written and lists some of the information contained in each 


record. 


Record Type 











When Written 


Whenever a START HASP 
command ts entered under VS2 
only. 


Whenever a STOP HASP 
command is entered under VS2 
only. 


Whenever an operator enters a 
Start Line command or when a 
sign-on is received from a 
remote user. 


Whenever an operator enters a 
Stop Line command or when a 
sign-off is received from a 
remote user. 


During RTAM initialization 
under VS1 only. 


Whenever a MODIFY RTAM 
command is issued under vVS1 
only. 


When a STOP RTAM command 
is issued under VS1 only. 


Whenever a valid LOGON record 


is received by RTAM under VS1 
only. 


Whenever a LOGOFF record is 
received by RTAM under VS1 
only. 


Whenever an invalid LOGON 
record is received by RTAM 
under VS1 only. 








Information Contained 


HASP information including subsystem 
identification and HASP options. 


HASP information including subsystem 
identification, date, and time. 


HASP information including subsystem 

identification, subsystem event, remote 
name, line name, password, and signon 
card information. 


HASP information including subsystem 
identification, subsystem event, remote 
name, line name, and password. 


RES information including name of RTAM 
Start procedure, maximum numbers of 
readers and writers, number of entries in 
LINE table, number of line DCTs, number 
of lines to activate, line names, and unit 
addresses. 


RES information including name of start 
procedure, type of MODIFY, number of 
lines modified, line numbers, and unit 
addresses. 


RTAM information including name of 
RTAM STOP procedure, stop status, and 
number of lines started when STOP was 
received. 


RES information including QID entry, 
passback area, and LOGON record. 


RES information consisting of the QID 
entry. 


RES information including the QID entry, 
passback area, and LOGON record. 





Figure 5. Table of Subsystem Records Showing When They Are Written 


and the Information They Contain 


See the chapter “Subsystem Records’”’ for more information on and the complete 
format of each of the subsystem records. 
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SYSOUT Messages 


User Written Routines 


In addition to the records written to the SMF data set, SMF writes four messages to 
the SYSOUT data set. These messages are assigned message numbers IEF3731, 
IEF3741, IEF3751, and IEF376l, and they indicate the start and end times for each job 
step and for each job. The text of these messages and an explanation of each is 
provided in OS/VS Message Library: VSI System Messages, GC38-1001, and 
OS/VS Message Library: VS2 System Messages, GC38-1002. 


Your installation should provide two types of routines to take full advantage of the 
features of SMF: 


« Analysis and report routines that process and format information contained in 
the SMF and user data sets. These routines may produce billing reports, list the 
SMF data set, use a sort/merge program to re-order the data, or perform 
detailed analysis operations. 


e Exit routines that periodically monitor jobs and can write user records to the 
SMF or installation defined data set. 


SMF provides exits in the control program that can be used by user written 
routines. User written routines can monitor each job at specific points from the 
time it is encountered in the input stream to the time all spooled output has been 
written. These routines are referred to as exit routines. 


Like execution time for any other part of the control program, the execution time 
of the exit routines is added to system overhead and will degrade system 
throughput. The amount of the degradation depends on the length of the routines 
and the number of times each is performed during processing of a job. The 
advantages of including exit routines must be weighed against the factors affecting 
system throughput when choosing which exits to use. It is possible (by the 
SMFDEFLT parameters) to specify at IPL the suppression of all exits or only 
Step-related exits, permitting the system to operate without the exit routines. 


The exits from the interpreter and the initiator/terminator can be taken by jobs in 
either the foreground or background. For VS2, the time limit exit can be taken by 
background jobs only. The SMF writer exit in VS2 is taken for each SMF record 
generated; it is not job related. 


An installation can make use of any or all of these exits by providing user written 
exit routines and including them in the system library SYS1.AOS00 before system 
generation or in the link library SYS1.LINKLIB and SYS1.NUCLEUS for VS1 or in 
SYS1.LPALIB for VS2 after system generation. Dummy routines are automatically 
provided for all unused exits for which you do not supply your own routines. 


The user written exit routines can cancel jobs, write user defined records to the 
SMF data set, access user defined data sets, or enforce installation standards, such 
as identification, priority, and resource allocation. Because these routines become 
part of the control program where errors can cause repeated system failure, 
thorough debugging is important. For more information on testing and debugging, 
see “Testing Exit Routines” in the chapter ‘Exit Routines.” 


The formats of the parameters passed to each exit routine are described in the 
chapter ‘“‘Exit Routines.’’ The procedure for adding user written routines to the 
system is described in the chapter “Incorporating SMF into the System.” 
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Exits Available to Both VS1 and VS2 


The exits available for use under both VS1 and VS2 are: 


e Job Validation (IEFUJV), which receives control from the job management 
routine of the control program before each job control statement (or cataloged 
procedure) encountered in the input stream is interpreted. One final entry is 
made after all of the JCL is interpreted. This exit is not taken for comment 
statements or for jobs started from the console. A return code from this exit 
specifies whether processing of this job is to continue. 


¢« Job Initiation (IEFUJI), which receives control from the initiator routine of the 
control program when a job on the input queue is selected for initiation. A 
return code from this exit specifies whether the job is to be started or canceled. 


e Step Initiation (IEFUSI), which receives control from the initiator just before 
each job step is started (prior to allocation). A return code from this exit 
specifies whether the step is to be started or the job canceled. 


e Time Limit (IEFUTL), which receives control from the timer interruption 
handler whenever one of the following time limits expires: the job CPU time 
limit from the JOB statement, the step CPU time limit from the EXEC statement 
or reader procedure, or the continuous wait time limit for the job from 
SMFDEFLT. A return code from this exit specifies whether the job step is to be 
terminated or processing continued with a new time limit. 


¢« Termination (IEFACTRT), which receives control from the terminator on the 
normal or abnormal termination of each job step and job. A return code from 
this exit specifies whether the job is to be continued or terminated (for job step 
entry only), and whether the SMF record is to be written or skipped. With 
SMF=BASIC in VS1 this routine also receives control at the beginning of 
allocation. There are no SMF records to be considered with SMF=BASIC. 


¢« Job Purge (IEFUJP), which receives control from the SYSOUT writer routine in a 
VS1 system or from the HASPACCT routine in a VS2 system with HASP when a 
job not started from the console is ready to be purged from the system (after 
the job has terminated and all SYSOUT output that pertains to that job has been 
written). This exit does not return a code to the control program in a VS1 
system. In a VS2 system with HASP, this exit does return a code which specifies 
whether the SMF record is to be written or skipped. 


Exits Available to VS1 Only 


The exits available for use under VSi only are: 


e Input Stream Validation (IEFUIV), which receives control from the input stream 
control routine every time a new job is encountered in the input stream when 
VS1 is used. A return code from this exit specifies whether a job is to be 
accepted for processing. 


¢ SYSOUT Limit (IEFUSO), which receives control from the I/O supervisor when 
the number of logical records written to a SYSOUT data set exceeds the output 
limit when VS1 is used. A return code from this exit specifies whether the job is 
to be terminated or processing continued using a new SYSOUT limit. 


Exit Available to VS2 Only 


Pap 


The exit available for use under VS2 only is: 


e SMF Record (IEFU83), which receives control from the SVC83 routine before any 
record is written to the SMF data set when VS2 is used. A return code from this 
exit specifies whether to suppress the SMF record that is to be written. 
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SMF Operation 


Initializing 


Job Processing 


Figure 6 shows SMF incorporated into the operating system. The following 
paragraphs, which describe Figure 6, assume that user written exit routines are 
supplied for all SMF exits!, that all SMF-formatted records? are written to the SMF 
data set, and that user written analysis and report routines are supplied. In any 
real application, of course, the exit routines that are supplied and the records 
specified to be written to the SMF data set depend on the installation’s 
requirements. 


At IPL, an SMF initialization routine receives control and reads in the member 
(SMFDEFLT) of SYSi.PARMLIB that contains SMF control parameters. The options 
specified in these parameters—including such options as whether both the data 
collection routines and the control program exits will be active and including the 
definition of the SMF data sets—will be typed out at the console if the operator is 
allowed to modify them for the current work day. (The default parameters can be 
permanently changed by replacing the member in SYS1.PARMLIB.) Before job 
processing begins, the SMF initialization routine records information about IPL, 
initial input/output configuration, and, for only VS1, the amount of storage 
assigned to each partition. 


As the input stream in VS1 is read in for processing, each new job causes control 
to pass to an input stream validation exit. This exit routine may verify whether the 
job is to be accepted for processing. Just before each job control statement is 
interpreted, the interpreter routine passes control to a job-validation exit routine. 
This routine may verify any fields in the JCL statement, modify JCL, or reject jobs 
that do not meet installation standards. After all JCL has been interpreted, the 
same job validation exit routine receives control for further validity checking. 


Before a job is initiated, the initiator routines pass control to a user written job 
initiation exit routine. In this routine, the user can decide whether to cancel or 
continue job processing based on accounting parameters associated with the job. 
Upon return from the routine, the SMF job commencement record is created and 
written to the SMF data set. This record is not written if the exit routine specifies 
that the job be canceled. 


Before a job step is initiated, control is passed to a step initiation user written exit 
routine. Here, processing similar to that done in the job initiation exit can be 
performed. 


When a step within the job ends either normally or abnormally, terminator 
routines create a job step record and, before the record is written, pass control to 
a user written accounting routine. The accounting routine may modify the SMF 
records, add a record to its own accounting data set, or add records to the SMF 
data set. This accounting routine also indicates whether the job is to continue (if a 
job step termination is being processed) and whether the job step termination 
record is to be written. Upon return, the job step record is written to the SMF data 
set unless the exit routine specifies that it be suppressed. 


At job termination, SMF creates a job information record and again passes control 
to the user written accounting routine. Upon return from this routine, the SMF job 
termination record is written unless the exit routine specifies that it be suppressed. 





1 Note that some exits are available only when VS1 is used, and that other exits are available only 
when VS2 1s used. 


2 The SMF records written under VS1 and vS2 are slightly different because of additional fields 
for VS2. 
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Figure 6. SMF in the Operating System 
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SMF Records 








Event Recording 


Dumping 


In VSi and in VS2 systems that include HASP, after the job has terminated and all 
SYSOUT output that pertains to a job and all output writer records have been 
written, control is passed to the final user written exit routine. 


Some types of information are recorded whenever particular situations arise. These 
types of information and the situations that cause their recording are: 


e Data set information, which is recorded whenever a data set opened by a user 
program is scratched, renamed, closed, or processed by end of volume (EOV). 


e Direct access volume information, which is recorded (1) for online, direct access 
devices at IPL, (2) when a volume is demounted, and (3) for online, direct 
access devices when a HALT EOD or SWITCH command is issued. 


e Configuration information, which is recorded when a DEFINE, VARY OFFLINE, 
or VARY ONLINE command is issued and after allocation recovery. 


e System statistics, which are generally recorded at the end of every ten minutes 
of elapsed system time and at the end of the day. 


Just as some types of information are recorded whenever particular situations 
arise, some types of exits are entered whenever particular situations arise. These 
types of exits and the situations that cause them to be entered are: 


e Time limit exit, which is entered whenever the step CPU, job CPU, or continuous 
wait time limits are reached. 


« SYSOUT limit exit in VS1, which is entered whenever the OUTLIM limit is 
reached. 


e SMF record exit in VS2, which is entered whenever an SMF record is ready to be 
written. 


Records are written to the primary SMF data set (SYSI.MANX) until the end of the 
allocated extent is reached. When the end of the allocated extent is reached, SMF 
opens the alternate SMF data set (SYSI.MANY) and continues recording. The 
operator is then notified to use the SMF dump program to copy SYSi.MANX to a 
dump data set. 


Note: If the operator failed to dump the requested SMF data set within a 
reasonable period of time, it is possible for the alternate SMF data set to also 
become full. When this occurs and the SMF buffer also fills, SMF will be in a data 
lost condition until dumping takes place. 


Similar recording and copying operations continue throughout the work day, with 
SMF adding special records whenever a VARY command or allocation recovery 
changes the system configuration and, at the end of specific intervals, to record 
system statistics, such as wait time. The HALT EOD and SWITCH SMF command 
from the operator cause the system statistics to be recorded and the SMF buffers 
to be emptied into the active SMF data set. This active data set is then closed and 
the previously inactive data set is made active and selected for recording. The SMF 
dump program may then be used to copy the inactive SMF data set to the dump 
data set, which contains a complete history of the day’s processing. The dump data 
set can serve as input to the user written analysis and report routines, which may 
be executed as ordinary problem programs under the operating system. 
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Post Processing 


Compatibility 





A user written routine may be used to list and total the system usage by account 
number. A separate analysis program can process the SMF records in the order 
recorded, to detect excessive system wait time or inefficient use of input/output 
devices. This information can lead to improved system throughput by suggesting 
changes in the job mixture or device allocation. 


The compatibility between SMF under VS1 and MFT, VS2 and MVT, and VS1 and 
VS2 is discussed in the following sections. 


SMF Compatibility Between VS1 and MFT 





VS1 SMF is compatible with MFT SMF with the following exceptions: 
« SYS1.MANX may not reside on tape for VS1 SMF. 
e« Two new exits, IEFUIV and IEFUJP, have been added for VS1 SMF. 


e The value received in any given field when operating under VS1 may differ from 
the value received when operating under MFT. 


« Several record types have been modified for VS1 SMF. Figure 7 lists the record 
types and the corresponding modifications. 


e The RES records 43R-45R and 47R-49R have been added for VS1. 
« The VSAM records 62, 64, 68, and 69 have been added for VS1. 


Record Types | Modifications 


Header System indicator added. 





Size of virtual storage replaces size of main storage. Size of real storage 
added. 





Paging statistics and time of end of interval added. 


Partition size replaces allocation for hierarchy 0. Storage used replaces 
hierarchy 0 storage used. Reserved fields replace hierarchy 1 fields. No 
device entry for spooled data sets. Step termination indicators and paging 
Statistics added. 


In job termination indicator, the ABEND bit turns on when any step 
abnormally terminates. The job completion code field contains the ABEND 
code for the last step that abnormally terminated, regardless of normal 
processing by successive steps. Reserved field replaces checkpoint/restart 
field. A user’s logon identifier has been added. 





A user's logon identifier has been added. 


12 Paging statistics and time of end of collection period added. 


13 Entry size increased by 12 bytes. 


Figure 7. Record Modifications from MFT for VS1 





SMF Compatibility Between VS2 and MVT 


VS2 SMF is compatible with MVT SMF with the following exceptions: 
e SMF is standard in VS2. 
e SYS1.MANX may not reside on tape for VS2 SMF. 


« Two new exits, IEFU83 and IEFUJP, have been added for VS2 SMF. IEFUJP is 
available only in VS2 systems that include HASP. 
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e Record type 26 has been added in a VS2 system with HASP. 
e One exit, IEFUSO, is not available in VS2 SMF. 


e The HASP subsystem records 43H, 45H, 47H, and 48H have been added to 
VS?2. 


| - The VSAM records 62, 64, 68, and 69 have been added for vS2. 


e The value received in any given field when operating under VS2 may differ from 
the value received when operating under MVT. 


e Several record types have been modified for VS2 SMF. Figure 8 lists the record 
types and the corresponding modifications. 


Record Types | Modifications 


Header System indicator added. 


Size of virtual storage replaces size of main storage. Size of real storage 
added. 


Paging statistics and time of end of interval added. 


Region size replaces allocation for hierarchy 0. Storage used replaces 
hierarchy O storage used. Reserved fields replace hierarchy 1 fields. Step 
termination indicators and paging statistics added. 


Reserved field replaces checkpoint/restart field. 


6 Additional HASP fields have been added for VS2 systems with HASP. 








12 Paging statistics and time of end of collection period added. 


30 Contains some of the fields that are in record type 38 in an MVT system. 
(Record type 38 is not produced in VSz2.) 











41 Contains some of the fields that are in record type 38 in an MVT system. 








Figure 8. Record Modifications from MVT for VS2 


SMF Compatibility Between VS1 and VS2 
VS1 SMF is compatible with VS2 SMF with the following exceptions: 
¢ For VS1, SMF is optional; for VS2, SMF is standard. 


e In VS2, SMF can be used on both batch (background) jobs and time sharing 
(foreground) jobs entered from a terminal with the time sharing option (TSO); 
in VS1, SMF can be used only on batch (background) jobs. 


« Exits that are available only in VS1 are IEFUIV and IEFUSO; the exit that is 
available only in VS2 is IEFU83. 


¢« Record types 13, 43R-45R, and 47R-49R are written only in VS1 systems; 
record types 26, 30-35, 40-42, 43H, 45H, 47H, and 48H are written only in 
VS2 systems. 
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e Several record types have additional fields for VS2. Figure 9 lists the record 
types and the corresponding modifications. 


e IEFUJP exit in VS1 points to accounting information; IEFUJP exit in VS2 with 
HASP points to record type 26. 


¢ Record type 26, 43H, 45H, 47H, and 48H are written only in VS2 systems with 
HASP. 


Record Types | Modifications 





More system statistics added. 


4 Device entries for spooled data sets have been added. 
5 


a A user's logon identifier has been added in vS1; it is reserved in VS2. 


A user’s logon identifier has been added in VS1. In a VS2 system with 
HASP, additional fields have been added. 





More system statistics have been added. 





Figure 9. Record Modifications from VS1 for VS2 
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Incorporating SMF into the Operating System 


SMF is specified when you generate your VS1 operating system. SMF is a standard 
function in a VS2 system. 


For VS1, SMF is an optional part of the system. To add SMF to your VS1 operating 
system, you must include SMF in the system generation statements. 


If you are going to record data in either VS1 or VS2, you must define your use of 
SMF either in SMFDEFLT or from the operator’s console, allocate direct access 
space for the SMF data set, and add any user written exit routines you want to the 
control program. The information needed to add SMF to the system is given in the 
topics that follow. 


Including Exit Routines in the System 


Exit routines are an optional feature of SMF. If you decide to use exit routines, we 
suggest you incorporate them into system library SYS1.AOS00 before you generate 
your system. Otherwise, they must be link-edited into the appropriate system load 
module. (For a discussion of adding the IEFUJP exit to HASP, refer to OS/VS2 

| HASP II Version 4 Systems Programmer’s Guide, GC27-6992.) 


Note: If an exit routine is link-edited into an active system, a link-edit failure may 
render inoperative the load modules into which the exit was being link-edited. This 
is particularly important in the case of termination exits, because a failure would 
result in the loss of the output that indicates the cause of failure. 


Figure 10 illustrates the JCL required to add exit routines to SYS1.AOS00 prior to 
system generation. If you do not require all exit routines in your system, simply 
omit the object deck and NAME control statement for those you do not need. 


If you wish to add or replace exit routines after system generation, you must 
link-edit the routines into the appropriate load module. Figure 11 shows the load 
module assignments. 


When adding exit routines after system generation in either VS1 or VS2, refer to 
your system generation listing for exact load module names and aliases. 


Figure 12 shows the JCL required to add exit routines to SYS1.LINKLIB after 
generating a VS1 system. 


Figure 13 shows the JCL required to add the exit routine IEFUTL to SYS1.NUCLEUS 
after generating a VS1 system. 


Figure 14 shows the JCL required to add exit routines to SYS1.LPALIB after 
generating a VS2 system. 
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//EXITLNK JOB 1 
tf 


23456,SMITH 


EXEC PGM=IEWL, PARM=(DC,LET,LIST,RENT,NCAL ) 
//SYSPRINT DD SYSOUT=A 
//SYSLMOD DD DSNAME=SYS1.A0S00,DISP=( OLD,KEEP ) 

J/SYSUT) DD UNIT=SYSDA,DISP=( ,DELETE ),SPACE=( TRK,(20,5)) 
* 


//SYSLIN DD 
(IEFUIV object deck)! 


NAME IEFUIV(R) 


(IEFUJV object deck) 


NAME TEFUJV(R) 


(IEFUJI object deck) 


NAME ITEFUJI(R) 


(IEFUSI object deck) 


NAME IEFUSI(R) 


(IEFUSO object deck)! 


NAME IEFUSO(R) 


(IEFUTL object deck) 


NAME ITEFUTL(R) 


IEFU83 object deck)? 


NAME IEFU83(R) 


(IEFACTRT object deck 


) 


NAME IEFACTRT(R) 


(IEFUJP object deck)3 


NAME IEFUUP(R) 


/* 


1 This exit is available only in VS1. 
2 This exit is available only in VS2. 
3 This exit is available in VS1 and in VS2 systems that include HASP. 


Figure 10. JCL for Adding Exit Routines to SYS1.A0S00 Prior to System 


Generation 





Object module for 
this exit routine 


IEFUIV 
IEFUJV 
IEFUIJI 
IEFUSI 
IEFUSO 
JEFUTL 
IEFU83 
IEFACTRT 








IEFUJP 





Must be link-edited into this load 
module in VS1 


IEFJES in SYS1.LINKLIB 
IEFUJV in SYS1.LINKLIB 
IEFSD162 in SYS1.LINKLIB 
IEFSD 162 in SYS1.LINKLIB 
IEFJES in SYS1.LINKLIB 
IEANUCO! in SYSI.NUCLEUS 





Not applicable 


IEFSD161 in SYS1.LINKLIB! 
IEFW21SD in SYS1.LINKLIB2 


IEFJES in SYS1.LINKLIB 








Must be link-edited into this 


load module in VS2 


Not applicable 

IEFUJV in SYS!1.LPALIB 
IEFSD061 in SYS1.LPALIB 
IEFSD061 in SYS1.LPALIB 


Not applicable 

IEFSD263 in SYS1.LPALIB 
IEFU83 in SYS1.LPALIB 
IEFSD06!1 in SYS1.LPALIB 


HASP in HASP library 





1 TEFACTRT must be link-edited into this load module if either SMF=BASIC or SMF=FULL 1s 


specified. 


2 IEFACTRT must also be link-edited into this load module if SMF=BASIC is specified. 


Figure 11. Required Load Module Assignments for Exit Routines 


OS/VS System Management Facilities (SMF) 


Note: You must refer to your system generation listing for exact load module 


names and aliases. 


//EXITLNK JOB 
//STEP1 EXEC 
//SYSPRINT DD 
//SYSLMOD DD 


123456,SMITH 
PGM=IEWL, PARM=( LET, LIST,NCAL, XREF ) 
SYSOUT=A 
DSNAME=SYS1.LINKLIB, DISP=( OLD, KEEP ) 


//SYSUT1 DD UNIT=SYSDA,DISP=( ,DELETE ),SPACE=( TRK,(20,5)) 
//SYSLIN DD * 
(IEFUJV object deck) 

ENTRY IEFUJV 

INCLUDE SYSLMOD( IEFUJV ) 

NAME IEFUJV(R) 
(IEFUJI and IEFUSI object decks) 

ENTRY ITEFSD062 

INCLUDE SYSLMOD( IEFSD162 ) 

ALIAS aliasnamel ,aliasname2,.. . 

NAME IEFSD162(R) 
(IEFACTRT object deck)! 

ENTRY IEFSD061 

INCLUDE SYSLMOD( IEFSD161 ) 

ALIAS aliasnameA ,aliasnameB, .. . 

ALIAS aliasnameX,aliasnameY,... 

NAME ITEFSD161(R) 
//STEP2 EXEC PGM=IEWL, PARM=(NCAL,LIST, XREF,LET, RENT ) 
//SYSPRINT DD SYSOUT=A 
//SYSLMOD DD DSNAME=SYS1.LINKLIB, DISP=( OLD,KEEP ) 
//SYSUT1 DD UNIT=SYSDA,DISP=( ,DELETE ),SPACE=(TRK,(20,5) ) 
//SYSLIN DD * 
(IEFUSO, IEFUIV, and IEFUJP object deck) 

ENTRY IEFJESCT 

INCLUDE SYSLMOD( IEFJES ) 

NAME IEFJES(R) 
/* 


1 When SMF=BASIC is Specified, IEFACTRT must also be link-edited in load module IEFW21SD. 


The required statements for this additional link-edit are as follows: 


ENTRY 
INCLUDE 
ALIAS 
NAME 


TEFJESCT 

SYSLMOD (ILEFW21SD) 
aliasnamel! ,aliasname2,... 
LEFW21SD(R) 


Figure 12. JCL for Adding Exit Routines to SYS1-LINKLIB After Generating 
a VS1 System 
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//NUCLINK JOB 123456,SMITH 
ve EXEC PGM=IEWL, PARM=(SCTR,LET,LIST,NCAL, XREF) 
//SYSPRINT DD SYSOUT=A 
//SYSLMOD DD DSN=SYS1.NUCLEUS,DISP=OLD 
//SYSUT1 DD UNIT=SYSDA,SPACE=(CYL,(2,2)) 
//SYSLIN DD #* 
INSERT  IEAANIPO 
INSERT  IEAAIHOO 
INSERT  IEAIOSOO 
INSERT  IEAASNT2 


Additional INSERT statements required! 


(IEFUTL object deck) 
INCLUDE SYSLMOD( ILEANUCO1 ) 
NAME IEFANUCO1(R) 

/* 


| These INSERT statements are variable according to your SYSGEN; therefore, refer to your 
SYSGEN listing for LINK EDIT of SYS1.NUCLEUS and copy the INSERT statements as found there. 


Figure 13. JCL for Adding IEFUTL to SYS1.NUCLEUS After Generating 
a VS1 System 


Note: You must refer to your system generation listing for exact load module 
names and aliases. 


//LINKEXIT JOB, 123456,J0ONES , REGION=300K 
//STEP1 EXEC PGM=IEWL, 
Tf PARM='LET, LIST, RENT, NCAL, XREF, REFR, SIZE=( 250K, 30K)! 
//SYSPRINT DD SYSOUT=A 
//SYSLMOD DD DISP=(OLD,KEEP ),DSN=SYS1.LPALIB 
//SYSUT1 DD UNIT=SYSDA,DISP=( ,DELETE), 
SPACE=( TRK,( 20,5) ) 
//SYSLIN DD * 
ENTRY LEFUJV 
(IEFUJV object deck) 
NAME IEFUJV(R) 
ENTRY TEFSD263 
(IEFUTL object deck) 
INCLUDE SYSLMOD( IEFSD263 ) 
NAME IEFSD263(R) 
//STEP2 EXEC PGM=IEWL, 
PARM='LET,LIST,RENT,NCAL, XREF,SIZE=( 250K, 30K)' 
//SYSPRINT DD SYSOUT=A 
//SYSLMOD DD DISP=(OLD,KEEP ),DSN=SYS1.LPALIB 
//SYSUT1 DD UNIT=SYSDA,DISP=( ,DELETE), 
Sf SPACE=( TRK,(20,5)) 
//SYSLIN DD * 
ENTRY ITEFSD061 
(IEFUJI, IEFUSI, and IEFACTRT object decks) 
INCLUDE SYSLMOD( IEFSD061 ) 
ALIAS aliasnamel ,aliasname2,... 
NAME IEFSD061(R) 
ENTRY ITEFU83 
(IEFU83 object deck) 
NAME ITEFU83(R) 
/* 


Figure 14. JCL for Adding Exit Routines to SYS1.LPALIB After Generating 
a VS2 System 
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SYSGEN Procedure 








One system generation macro instruction, SCHEDULR, is specifically related to 
SMF. In either VS1 or VS2, the parameters you supply for the SCHEDULR macro 
instruction depend on your installation requirements. For example, if you require 
record type 21 to be written, the ESV parameter of the SCHEDULR macro 
instruction must specify SMF. If you are recording, the value of the JOBQLMT 
parameter in the SCHEDULR macro instruction must be increased to include two 
additional messages per job and per job step and additional system queue space 
must be specified in the CTRLPROG macro instruction (using the SYSQUE 
parameter for VS1 or the QSPACE parameter for VS2). 


One system generation macro instruction, JES, is related to SMF in VS1. 
Specifically, the VS1 exit IEFUSO is related to the OUTLIM parameter of this macro 
instruction. 


Additional SYSGEN requirements must be fulfilled to add RES, VSAM, or TSO to 
your system. For a complete discussion of the system generation procedure, refer 
to OS/VSI System Generation Reference, GC26-3791, and OS/VS2 System 
Generation Reference, GC26-3792. 


In VS1, you may specify in the SCHEDULR macro instruction one of the following: 


e SMF=NOTSUPPLIED, which specifies that no SMF processing is to be provided. 
If the SMF parameter is not coded and the ESV parameter of the SCHEDULR 
macro does not specify SMF, NOTSUPPLIED is the default. 


e SMF=BASIC, which specifies that user written accounting routines, Job Entry 
Subsystem (JES) accounting information, and exits IEFUSO, IEFUJP, and 
IEFACTRT are to be provided. No SMF records are generated. For further 
information on handling accounting information when SMF=BASIC is specified, 
refer to OS/VSI Planning and Use Guide, GC24-5090. 


e SMF=FULL, which specifies that the SMF routines, additional JES accounting 
information, and exits IEFUIV, IEFUJV, IEFUJI, IEFUSI, IEFUSO, IEFUTL, 
IEFACTRT, and IEFUJP are to be provided. If the SMF parameter is not coded 
and the ESV parameter specifies SMF, FULL is the default. 


Figure 15 provides more detailed information about the availability of exits in VS! 
when BASIC or FULL is coded. 


Input Stream Control IEFUIV no yes 
Interpreter IEFUJV no yes 


Job Initiation IEFUJI no yes 





Step Initiation IEFUSI no yes 








yes 
Timer 
Allocation 
Step Termination 
Job Termination 


Job Purge JIEFUJP yes yes 











Figure 15. Availability of Optional Exits Supported by SMF in VS1 
When BASIC or FULL Is Coded 
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The OUTLIM function, which limits the number of logical records written to 
non-direct SYSOUT data sets, is always supported in VS1. The IEFUSO exit, which 
can be used to override the output limit, is supported if BASIC or FULL is coded. 


Defining Use of SMF for Both VS1 and VS2 Systems 


Required Parameters 


JWT Parameter 


The way you intend to use SMF for both VS1 when SMF=FULL is specified and for 
VS2 is defined through SMFDEFLT. SMFDEFLT parameters can be grouped as 
follows: 


¢ Required parameters, which must always be included and specify the job wait 
time limit and the system on which SMF is active. 


« Optional parameters, which include parameters to select record types, to specify 
physical information about the data sets, to permit operator modification, and to 
specify whether exits are to be taken. 


SMFDEFLT parameters can be specified either (1) before the first IPL of a newly 
generated system by adding SMFDEFLT as a member in SYS1.PARMLIB, (2) at each 
initialization of SMF by entering SMFDEFLT parameters at the console during IPL, 
or (3) in VS1 only, by the setup and subsequent use of the Automated System 
Initialization facility (see VS1 Release 2 Guide, GC24-5097). However, note 
that if a job is recovered in a warm start, the setting of six parameters (SID, MDL, 
OPT, DSV, REC, and EXT) will be the setting in effect when the job was read in, 
rather than the setting done during the warm start IPL. See “Entering SMFDEFLT 
into SYS1.PARMLIB” later in this chapter for information on coding and entering 
SMFDEFLT parameters. 


The system is distributed with an SMFDEFLT parameter list. These parameters for 
VS2 are shown in Figure 16. The parameters are the same for VS1 except for SID 
and MDL. (In VS1, SID is equal to 4A and MDL is equal to 45.) You should modify 
this list according to your system requirements. For example, for the PRM and ALT 
parameters, you should specify the volume serial number of the volume on which 
you are recording. 





OPT=2 , EXT=YES , SID=H1, BUF=2000,JIWT=10,MDL=55, 
OPI=YES ,MAN=ALL, PRM=SYSSMF,ALT=SYSSMF 


Figure 16. Parameters in the Sample SMFDEFLT Data Set 


Three of the SMFDEFLT parameters are required in order to run SMF in a VS2 
system or in a VS1 system where SMF=FULL is specified. These three parameters, 
described in the topics that follow, are: 


e JWT, which specifies the job wait time limit. 
e SID, which identifies the system on which SMF is active. 
e MDL, which defines the model identifier of the system on which SMF is active. 


The JWT parameter is a required parameter that specifies the number of minutes a 
job is allowed to remain continuously in the wait state. When the specified limit 
has been reached, the time limit exit (IEFUTL) is entered if exits are to be taken. 
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SID Parameter 


MDL Parameter 


Optional Parameters 


The format of the JWT parameter is: 
JIWT=n 
where: 


n 
represents a decimal number containing a maximum of three digits. It specifies 
the number of minutes that is the continuous wait time limit for jobs in the 
system. The value specified must be greater than 0. 


The SID parameter is a required parameter that identifies the system on which SMF 
is active. 


The format of the SID parameter is: 
SID=xx 
where: 


xx 
represents two alphameric characters identifying the system on which SMF is 
active. 


Note: The information specified by the SID and MDL parameters is treated as one 
field in SMF records. Therefore, the last character of the SID parameter may be 
considered to be the first character of a three-character MDL specification. 


The MDL parameter is a required parameter that defines the user-supplied model 
identifier of the system. 


The format of the MDL parameter is: 
MDL=xx 
where: 


xx 
represents two alphameric characters selected by the user to identify the model 
of his system. 


Note: The information specified by the SID and MDL parameters is treated as one 
field in SMF records. Therefore, if you want to specify three digits for the MDL 
parameter, enter the first digit as the last digit of the SID parameter. For example, 
if the system identification is ““B’’ and the model is “145,” specify SID=B1 and 
MDL=45. 


Nine of the SMFDEFLT parameters are optional. The optional parameters used to 
select record types are: 


e MAN, which specifies the type of records (all, none, or only user) to be written 
to the SMF data set. 


e OPT, which specifies the type of system, job, and job step information to be 
collected. 


e DSV, which specifies the type of data set information and/or direct access 
volume information to be collected. 


e REC, which specifies whether or not temporary data set information is to be 
collected. 


Incorporating SMF into the Operating System 35 


MAN Parameter 


OPT Parameter 


The optional parameters used to specify physical information about the data sets 
are: 


e BUF, which specifies the size of the SMF buffer. 
e PRM, which specifies the primary SMF data set. 
e ALT, which specifies the alternate SMF data set. 
The other two optional parameters are: 


e OPI, which specifies whether or not the operator is allowed to modify 
parameters. 


e EXT, which specifies whether or not exits will be taken. 


The MAN parameter is an optional parameter that specifies the type of records to 
be written to the SMF data set. This parameter must be specified as MAN=ALL or 
MAN=USER if records are to be written to the SMF data set. If MAN is equal to 
ALL or USER, the parameters BUF, PRM, and ALT are required. If records are 
going to be written only to an installation-defined data set, the parameter may be 
specified as MAN=NONE. If MAN is equal to NONE, the OPT, DSV, and REC 
parameters have no function and user exits cannot write to the SMF data set. 


The format of the MAN parameter is: 
[MAN={NONE | USER | ALL}] 
where: 


NONE 
specifies that no records are to be written to the SMF data set. 


USER 
specifies that only user records (from user written exit routines) are to be 
written to the SMF data set (that is, only record types 128 through 255 are 
written). 


ALL 
specifies that both SMF and user records are to be written to the SMF data set. 
If the parameter is omitted, ALL is assumed. 


If MAN=NONE is specified, no records are written to the SMF data set, regardless 
of the values specified in the OPT, DSV and REC parameters. If MAN=ALL is 
specified, all SMF records are created, unless suppressed by the OPT, DSV, or REC 
parameters. All of the records created are written unless suppressed by a user 
written exit routine. 


The OPT parameter is an optional parameter that specifies the type of system, job, 
and job step information to be collected by SMF. 


The format of the OPT parameter is: 
(OPT = {1 | 2}] 
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DSV Parameter 


REC Parameter 


where: 


1 
specifies that only system and job information is to be collected by SMF (that 
is, record type 4, which contains job step information, is suppressed) and that 
the step-related exit, IEFUSI, is not taken. 


2 
specifies that system, job, and job step information is to be collected by SMF. If 
the OPT parameter is omitted, 2 is assumed. 


Note: If OPT=1 is specified, and if DSV=2 or DSV=3 is also specified, the value 
OPT=2 is used instead of OPT=1 and message IEE3591 is produced. 


The DSV parameter is an optional parameter that specifies the type of data set 
information and/or direct access volume information to be collected by SMF. 


The format of the DSV parameter is: 
[DSV={0] 112133] 
where: 


0 
specifies that neither data set information nor direct access volume information 
is to be collected by SMF (that is, record types 14, 15, 17, 18, 19, 20, 62, 64, 
68, and 69, which contain data set information and direct access volume 
information, are suppressed). If the parameter is omitted, 0 is assumed. 


specifies that direct access volume information (record types 19 and 69) is to 
be collected by SMF and record types 14, 15, 17, 18, 20, 62, 64, and 68, which 
contain data set information, are suppressed. 


specifies that data set information (record types 14, 15, 17, 18, 20, 62, 64, and 
68) is to be collected by SMF and record types 19, and 69 which contain direct 
access volume information, are suppressed. 


specifies that both data set information and direct access volume information 
(record types 14, 15, 17, 18, 19, 20, 62, 64, 68, and 69) are to be collected by 
SMF. 


Note: If OPT=1 is specified, and if DSV=2 or DSV=3 is also specified, the value 
OPT=2 is used instead of OPT=1, and message IEE359I is produced. 


The REC parameter is an optional parameter that specifies whether record type 17 
will be written for temporary data sets.! This parameter is not functional unless 
you have specified DSV=2 or DSV=3. 


The format of the REC parameter is: 


“ [REC={0/ 21) 


1 The system determines that a data set is temporary if it has a system generated name and is 
created within a job or job step and exists only for the duration of that job or job step. The 
system generates a name when the DD statement for a new data set does not include the 
DSNAME parameter, or when it contains a parameter of the form DSNAME= & name or 
DSNAME= & & name. 
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BUF Parameter 


PRM Parameter 


ALT Parameter 


where: 


0 
specifies that record type 17 is to be written for only non-temporary data sets 
and is to be suppressed for temporary data sets. If the parameter is omitted, 0 
is assumed. 


specifies that record type 17 is to be written for temporary data sets as well as 
for non-temporary data sets. 


The BUF parameter is an optional parameter that specifies the size of the SMF 
buffer. This parameter must be specified if the MAN parameter is specified as 
MAN=ALL or MAN=USER. If neither SMF records nor user records are to be 
recorded, this parameter is not required. Buffer size requirements are discussed in 
“System and Partition Queue Areas” in the chapter ‘System Information and 
Requirements.” 


The format of the BUF parameter is: 
[BUF =n | 
where: 


n 
represents a decimal number containing three to four digits. The number defines 
the size (in bytes) of the SMF buffer. Minimum buffer size is 400 bytes; 
maximum buffer size is 8,192 bytes. If the value is not a multiple of 8, it is 
rounded to the next /ower multiple of 8. 


Note: You must dump the SMF data set(s) before you reduce the buffer size from 
the size specified at the previous IPL; otherwise, the SMF data set cannot be 
retrieved successfully. 


The PRM parameter specifies the primary SMF data set (SYSI.LMANX). This 
parameter must be specified if the MAN parameter is specified as MAN=ALL or 
MAN=USER. If neither SMF records nor user records are to be recorded, this 
parameter is not required. 


The format of the PRM parameter is: 


PRM= { vol.ser.no. } 
{(, dev.add. )} 


where: 


vol.ser.no. 
represents one to six alphameric characters specifying the serial number of the 
direct access volume on which the SYS1.MANX data set resides. 


deyv.addr. 
represents three alphameric characters specifying the address of the device on 
which the volume containing the SYS1.MANX data set is mounted. 


The ALT parameter specifies the alternate SMF data set (SYS1.MANY). This data 
set must be defined on the same type of direct access device as the primary data 
set (SYS1.MANX). This parameter must be specified if the MAN parameter is 
specified as MAN=ALL or MAN=USER. If neither SMF records nor user records are 
to be recorded, this parameter is not required. 
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Cc 


OPI Parameter 


EXT Parameter 


The format of the ALT parameter is: 


ALT= { vol.ser.no. } 
{(, dev.add. )} 


where: 


vol.ser.no. 
represents one to six alphameric characters specifying the serial number of the 
direct access volume on which the SYS1.MANY data set resides. 


dev.adadr. 
represents three alphameric characters specifying the address of the device on 
which the volume containing the SYSI.MANY data set is mounted. 


The OPI parameter is an optional parameter that specifies whether the operator 
will be permitted to modify SMFDEFLT parameters from the console during IPL. 
The OPI parameter is ignored if it is entered from the console. 


The format of the OPI parameter is: 
[OPI={YES | NO}] 
where: 


YES 
specifies that the operator is allowed to modify parameters. 


NO 
specifies that the operator is not allowed to modify parameters. If the parameter 
is omitted, NO is assumed. 


The EXT parameter is an optional parameter that specifies whether the SMF exits, 
with the exception of the VS1 exit IEFUSO, are to be taken. This parameter is 
independent of the value specified for the MAN parameter. (The IEFUSO exit is 
taken when the OUTLIM limit is reached for VS1 systems generated with the 
SCHEDULR macro instruction keyword SMF=BASIC or SMF=FULL.) 


The format of the EXT parameter is: 
[EXT= {YES | NO}] 
where: 


YES 
specifies that exits are to be taken. If the parameter is omitted, YES is assumed. 


NO 
specifies that exits are not to be taken. 


If EXT=YES is specified, the exits actually taken will depend on the data-collection 
parameter (OPT). If OPT=2 is specified, all exits defined for the system will be 
taken; if OPT=1 is specified, the job step initiation exit and job step termination 
exit will not be taken. 
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Selecting SMF Records Using SMFDEFLT Parameters 


Figure 17 summarizes the use of the SMFDEFLT parameters to select SMF records. 






ALL All SMF records. 





MAN NONE No SMF records. 







records. 





System and job 
information. 


information. 






sets or direct access 
volumes. 


information. 











No information for 
temporary data sets. 





Temporary data set 
information. 








Value Meaning Effect on SMF Records 





USER Only user-formatted SMF 


System, job, and job step 


No information for data 













Direct access volume 





Data set information. ! 


Data set and direct access 
information.! 








Record types 0 through 255 may be 
written to the SMF data set. 


The SMF data set is not used. 


st, 





Only record types 128 through 255 may 
be written to the SMF data set. 











Record types 0-3, 5-13, 26 (in a VvSs2 
system with HASP), 43H, 45H, 47H, 

48H, and 49R are created, but record 
type 4 is suppressed. Messages IEF3751 
and IEF376I are provided. 









Record types 0-13, 26 (in a VS2 system 
with HASP), 43H, 45H, 47H, 48H, and 
49R are created, and messages IEF3731 
through IEF376I are provided. 





Record types 14, 15, 17, 18, 19, 20, 62, 
64, 68, and 69 are suppressed. 






Record types 19 and 69 are created, but 
record types 14, 15, 17, 18, 20, 62, 64, 
and 68 are suppressed. 


Record types 14, 15, 17, 18, 20, 62, 64, 
and 68 are created, record types 19 and 
69 are suppressed. 


Record types 14, 15, 17, 18, 19, 20, 62, 
64, 68, and 69 are created. 























Record type 17 is created for 
non-temporary data sets only. 





Record type 17 is created for temporary 
data sets as well as for non-temporary 
data sets. 


1 OPT must equal 2 if DSV is 2 or 3. If OPT equals 1 and DSV equals 2 or 3, the value OPT=2 is 
substituted. 


Figure 17. Summary of the Use of SMFDEFLT Parameters to Select SMF Records 


Specifying SMF Parameters for TSO (VS2 Only) 


When SMF is present in a system that has Time Sharing Option (TSO), SMF 
information and exits are available for the TSO jobs. The SMF parameters for TSO 
can be defaulted or can be specified separately. The defaults for a START TS 
command are the parameter values in effect for the background. The defaults for a 
MODIFY TS command are the parameter values in effect for the foreground. The 
options for TSO are separately specified by (1) adding the TSO SMF parameters to 
any member in SYS1.PARMLIB and referencing the member on a START TS 
command or (2) overriding the TSO-related background parameters in a START TS 
or MODIFY TS command if operator intervention is specified in the SMFDEFLT 


member. 
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The format of the SMF options that can be specified for TSO is: 
SMF=({OFF | OPT=1 | OPT=2},{EXT=YES | EXT=NO}) 

where: 

OFF 
specifies that only TSO system records (types 30 through 33, 41, and 42) are to 
be generated. 

OPT=1 
specifies that TSO system and step (session) records are to be written and that 
job-level exits are to be taken if EXT=YES is specified. TSO step records (types 
34 and 40) are not to be written and step-level exits are not to be taken. 

OPT=2 
specifies that TSO system, session, and step records are to be written. Both job 
and step-level exits are to be taken if EXT=YES is specified. 

EXT=YES 
specifies that user exits allowed by the value specified in OPT are to be taken 
from TSO jobs. 

EXT=NO 
specifies that user exits are not to be taken from TSO jobs, regardless of what is 
indicated in the OPT field. 


The OPT and EXT parameters for TSO jobs are separate from the same parameters 
for background jobs. However, the options assigned for TSO cannot be more 
comprehensive than those specified for background jobs; for example, if job step 
records are not written for background jobs, they are not written for TSO jobs. 


Note: If DSV=2 or DSV=3 is specified for the background, OPT=2 must be specified 
for the foreground. If OPT=1 is requested for the foreground, OPT=2 is substituted. 


Figure 18 shows the interaction of values specified for background and TSO jobs. 
The values assigned for background jobs are not affected by values assigned for 
TSO jobs. 


Background | TSO Value | TSO Value 
Value Requested Assigned 


OPT=1 OPT=1 OPT=1 
OPT=1 OPT=2 OPT=1 


OPT=2 OPT=1 OPT=1 








OPT=2 OPT=2 OPT=2 
EXT=YES EXT=YES EXT=YES 
EXT=YES EXT=NO EXT=NO 


EXT=NO EXT=YES 
EXT=NO EXT=NO 











Figure 18. Interaction of OPT and EXT Values Specified for Background and TSO 
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Selecting SMF Records Using TSO Parameters (VS2 Only) 


You can also select types of records to be written to the SMF data set through the 
use of TSO parameters OPT and OFF when operating SMF in VS2. Figure 19 
summarizes the use of the TSO parameters to select SMF records. 


Meaning Effect on SMF Records 
OPT 1 


TSO system and session Record types 30-33, 35, and 41-42 are 
records. created, but record types 34 and 40 are 
suppressed. 










Record types 30-35, and 40-42 are 
created. 


Record types 30-33, 41, and 42 are 
created, but record types 34, 35, and 40 
are suppressed. 


TSO system, session, and 
step records. 







TSO system records. 











Figure 19. Summary of the Use of TSO Parameters to Select SMF Records 


Entering SMFDEFLT into SYS1.PARMLIB 


SMFDEFLT consists of a series of parameters contained in 80-character, card-image 
records. When you have determined the parameters for SMFDEFLT, you must have 
them punched into a card deck and added as a member of SYS1.PARMLIB. 


Each parameter has the format: 
keyword={ value | (value/ value2,...,valuen )} 


When punching the parameters into a card deck, consecutive parameters are 
separated by commas and no embedded blanks are permitted. Although parameters 
may be included in any order, you must conform to the following restrictions in 
coding SMFDEFLT parameters: 


e Parameters cannot be placed in columns 72 through 80; these columns are 
ignored. 


e« Continuation of statements must be indicated by placing a blank character after 
the delimiting comma and before column 72. (All records in the member except 
the last one indicate continuation.) 


e« A parameter cannot be divided between two records. Each set of parameter and 
value must be complete within a single record. 
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You should add the SMFDEFLT card deck as a member of SYS1.PARMLIB by 
executing the IEBUPDTE utility program. Figure 20 illustrates the JCL required to 
execute the utility program. 


If your parameters change, you may replace the entire SMFDEFLT member with a 
new version by again executing IEBUPDTE. For information on the IEBUPDTE 
program, refer to OS/VS Utilities, GC35-0005. 


If operator intervention is allowed (OPI=YES), you may change SMFDEFLT 
parameter values from the operator’s console during IPL. If parameter errors occur, 
the operator is prompted for correct parameters regardless of the value specified 
for OPI. 


//ENTER JOB  123456,SMITH 
EXEC PGM=IEBUPDTE, PARM=NEW 
//SYSPRINT DD SYSOUT=A 
//SYSUT2 DD DSNAME=SYS1.PARMLIB, DISP=(OLD,KEEP )! 
//SYSIN DD DATA 
./  BDD  LIST=ALL,NAME=SMFDEFLT, LEVEL=01,SOURCE=0 


(SMFDEFLT data set) 
/*® 


1 If you want to access SMFDEFLT on the distribution package before generating your system, the 
data set name is SYS1.APARMLIB. 


Figure 20. JCL Required for Entering SMFDEFLT into SYS1.PARMLIB 
Using IEBUPDTE 


Note: If you do not have SMFDEFLT as a member in SYS1.PARMLIB, the 
parameters must be entered from the operator’s console during IPL. 
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System Information and Requirements 


To effectively plan for and use SMF, you must have knowledge of system 
requirements (including main and auxiliary storage requirements), of system 
throughput and performance options, and of operational considerations. These 
topics are discussed in the remainder of this chapter. 


System Requirements 


SMF requires additional main storage, and it requires auxiliary storage. 


Main Storage Requirements 
SMF requires additional main storage space for the VS1 nucleus, the system queue 
area, and, if exit routines are included, space for system tasks. 

Nucleus and System Link Pack Areas 


The storage required for the VS1 nucleus is 2,300 bytes plus 148 bytes for each 

partition. An additional 1,560 byte area is required in the VS1 pageable nucleus 

and in the VS2 pageable system link pack area for the SMF writer routine. 
System and Partition Queue Areas 


Main storage is required in both VS1 and VS2 for the Timing Control Table (TCT), 
System Management Control Area (SMCA), the common parameter area for user 
written exit routines, and the SMF buffer. Figure 21 shows the areas of each 
system that require the additional storage. 


‘tor st~é~<C~stsC*d ie PQA Fixed LSQA 
SMCA Fixed SQA Fixed SQA 
Fixed PQA _| Fixed LSQA 


SMF Buffer Pageable SQA Fixed SQA 


Figure 21. System Areas that Require Additional Storage 




















One TCT is created for each active job step. If only job accounting is required 
(OPT=1), the size of each TCT is 116 bytes. If job step accounting is required 
(OPT=2), the size of each TCT is determined by the following formula: 


TCT = 132 + 12@) + 80) 
where: 


a 
is the maximum number of DD statements per job step. 


b 
is the number of devices allocated because of each DD statement. 


The SMCA is a permanent table occupying 148 bytes in VS1 and 172 bytes in vsz. 


The area used for communication between user written exit routines is discussed in 
“Exit Routine Facilities and Restrictions’ in the chapter “Exit Routines.” 
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To determine the SMF buffer size required, you must understand how the buffer is 
used. SMF records are blocked internally in variable-length format and, if 
necessary, spanned before they are written to the SMF data set. To allow 
overlapping of blocking and writing, the buffer size defined by the BUF parameter 
in SYS1.PARMLIB is divided into two equal parts; while one half of the buffer is 
being filled, the other half can be written. 


If records are to be written to the SMF data set, you must supply a buffer size in 
the SMFDEFLT data set before or during IPL. The minimum BUF size is 400 bytes; 
the maximum is 8,192. The size specified should be twice the size of the largest 
record to be written to the SMF data set to eliminate the need to span records.! 
More than one record can be written in half the buffer if record sizes permit, but 
if a record exceeds half the buffer, it is written as segments of a spanned record. 
To improve performance, the SMF buffer size should be defined to eliminate the 
need to span records. Note, however, that if the system fails, any records in the 
buffer are lost. Therefore, do not make the buffer larger than necessary. 


Figure 22 shows a list of buffer sizes and the corresponding number of average 
jobs that can be written on single track of various direct access devices. The 
figures have been adjusted to allow for interrecord gaps. See ‘SMF Data Sets”’ 
later in this chapter for a sample tabulation of some of the SMF records and their 
sizes. If you plan to reduce the size of the buffer during consecutive IPLs, dump 
the SMF data set(s) by using the SMF dump program (IFASMFDP); otherwise, the 
SMF data set cannot be retrieved successfully. 


Physical | Jobs per Track 
Buffer | Record 
Size | Length 

















10.5 
2,200 1,100 5.5 11.0 


1,300 6.5 | 11.5 
6.0 


6,000 3,000 12.0 














Figure 22. SMF Buffer Size and Use of Direct Access Space 
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SMF requires auxiliary storage for the SMF data sets and the expansion of system 
libraries. 


1 The Block Descriptor Word (four bytes) and the Record Descriptor Word (four bytes) should be 
included in the calculation of the largest record size. 
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SME Data Sets 


System Libraries 


Performance 


The SMF data set must be permanently resident on a direct access device. The 
ability of SMF to record data in time sequence order on SYS1.MANX and 
SYSI.MANY across system failures IPLs, and the dumping of full data sets is based 
on the assumption that the data sets are allocated to the same device types and 
have the same amount of space. Several factors, such as specific system 
configuration, amount of SMF data to be written, and report program 
requirements, will determine which type of device is more efficient for a particular 
installation. 


Space must be allocated for the primary SMF data set (SYS1.MANX) and for an 
alternate SMF data set (SYS1.MANY). The two data sets need not be defined on the 
same physical device, but they must be of the same type. Only device types on 
which system resident volumes are supported may be used, but, if possible, a 
device and channel other than those specified for SYSRES should be used. 


The devices used for the data sets are defined in SMFDEFLT and become 
permanently resident at IPL. The devices must be on line and ready during IPL. 
Space for the SMF data sets must be allocated prior to IPL. 


Switching between the primary and alternate data sets is automatic as each 
becomes filled. The SWITCH or HALT command, however, can be used to switch 
between the data sets whenever you choose. The SMF dump program must be used 
to transfer a full data set to tape. When a dump is completed, the status of the 
data set is reset to empty by the dump program. 


The space to be allocated to the SYS1.MANX and SYS1.MANY data sets depends on 
the average amount of data generated by each of your jobs and how often you 
want to dump the alternating data sets. The method for allocating space for SMF 
data sets on direct access devices is shown in “‘Data Management Procedures” 
later in this chapter. Figure 23 shows the size of some of the records that can 
appear in an SMF data set. 


Figure 24 is an example of how the VS1 space requirements for an entire data set 
can be established, given certain assumptions. Similar calculations can be made for 
a VS2 system. The ESV record (type 21), the Data Lost record (type 7), and RES 
records (types 43R-45R and 47R-49R) are not shown in this example. 


SMF requires direct access device space for expansion of system libraries when 
exits are used. In VS1, the system libraries SYS1.LINKLIB and SYS1.NUCLEUS 
require expansion space. In VS2, the system library SYS1.LPALIB requires expansion 
space. Refer to OS/VSI Storage Estimates, GC24-5094, and OS/VS2 Storage 
Estimates, GC28-0604, for more information. 


SMF will reduce system throughput by various amounts depending on such factors 
as: 


e SMF options selected, especially buffer size, SMF data set size, and SMF data set 
device. 


e Execution times of user written exit routines. 
e System configuration, especially the type and degree of multiprogramming. 


e Job stream characteristics, such as the number of jobs, the type of jobs, and 
any user data set requirements. For example, a job stream consisting of 
short-running job steps causes more system overhead than a job stream 
consisting of longer-running job steps. 
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Use Factor Definition Record 
Type Record Size (in Bytes) 
DSV= No. 


Category of 


Event or Status 


Partition Definition 


Day Data Devices Online at IPL 


End of day 
Accumulated Wait Time 
SMF Records Lost 


Machine Data Devices Varied Online 


Device Varied Offline 
Device Recovered by Allocation 


ia: Space Available on DASD 
Seay , | Volumes at IPL, HALT EOD, 
8 and when Demounted 


VSAM Data Space Defined, ALL 
Extended, or Deleted 


Job Processing ALL 


Job Purge (in VS2 with HASP) So 


Step Processing 


Data 





MAN= 





16 + 22 per partition 


16 
+ 4 per device 


34 (VS1); 54 (VS2) 
34 (VS1); 54 (VS2) . 


16 * 
+ 4 per device 


44 








> 
‘= 
tC 
Ww 


64 


102 


117 


N 


+ 1 per accounting data item 
+ 1 per accounting data character 





No 
ON 


224 


Processing 
Data 


117 
+ 8 per DD statement 
+ 1 per accounting data item 


+ 1 per accounting data character 5 
64 (VS1) J 


57 (VS2 without HASP) 
90 (VS2 with HASP) 









ALL 


SYSOUT Processing 
ALL 


== 
ve 
— — 


61 
+ 1 per accounting data item 
+ 1 per accounting data character 








Initiation of a Job with Data Set 
Activity Recording 


> 
cage 
7 


N 
Ww 
bo 


Data Set 

Opened for 
INPUT, or 
RDBACK . 


264 
+ 24 per UCB 
+ 28 for ISAM 


> 
‘= 
7 
id 
Ww 
rm 


Closing, or 
EOV 
Processing of a 
Data Set 











Data Set 
Opened for 
OUTPUT, 
UPDATE, 
INOUT, 
OUTIN . 


ae ae 
(on eats 
Closed or EOV 
eel 


VSAM Catalog Entry Renamed 


264 
+ 24 per UCB 
+ 28 for ISAM 


Data Set 
Activity Data 


N 
oS) 





88 
+ 8 per data set scratched 
132 
+ 8 per data set renamed 
138 % 
+10 per volume 
228 
+26 per extent t 
VS Data Record Descriptor Word 


Management | pigck Descriptor Word a nel 


Figure 23. SMF Record Sizes > 
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E ] E le Total 
No Gk Example cicen edn 


No. of 

Bytes per 3 Raat Related  Srmgm Reed Related 
Record Records 3 Raat  Srmgm Reed 

Partition Definition 


a: ee 
Once per day (4 partitions) 104 | 
i 20 devices, including 6 DASD — 
= foes 
mani 7 a 
Total for these records fF oaeoe 


Record 
Type 











Event or Status Assumption for This Example 








Devices Online at IPL 

Accumulated Wait Time Le Once every 10 min. for 4 hours — 
Device Varied Online Fog Twice per hour for 4 hours 
Device Varied Offline Twice per hour for 4 hours 


Device R d at 10 44 
Scratch a Non-temporary 17 Once per 4 hours, | volume per 
Data Set data set 
18 Once per 4 hours, 1 volume per 140 
fRename Dataset | 8 [Qrceger hour, volume per | 140 
Rename a VSAM catalog 1 


Accounting Data! 


Demount 2 DASD volumes 
161 


4 DD statements per step?, 
Accounting Data!, 3 steps per 
job 










2,871 















Job Processing 


1 EOV processing and close 2 
data sets per step, 3 steps per 
job 











Step Processing 1 EOV processing and close 2 


data sets per step, 3 steps per 
job 


Open 2 components per step, 1 
per job 


1 EOV and 1 close per VSAM 
component 


SYSOUT Processing aaee. writers per step, 3 steps 


| rl a A Se 6,200 
[Block Descriptor Word | Records per block | # | 289 1,036 
ne eT el 


1 In this example, accounting data consists of two 5-byte items. 

2 None of the four DD statements refers to DD DATA, DD *, or SYSOUT data sets. 

3 If you have VSAM data sets and DSV of 2 or 3, VSAM record types 63 and 67 are written. These records require a large amount of 
space of the SMF data set. Refer to Virtual Storage Access Method (VSAM) System Information Guide, GC26-3835. 















Figure 24. Example of Data Set Space Requirements For VS1 
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Operational Considerations 


The system operator is responsible for operational procedures, such as the 
requirements for IPL and for dumping the SMF data set, and for any special 
procedures required by user written report and analysis routines. 


IPL Procedures 


SMF initialization is the final step of the system IPL procedure. The SMF 
initialization program checks for the existence and validity of the SMFDEFLT 
member and for the availability of the devices on which data sets SYS1.MANX and 
SYS1.MANY are defined. 


If SMFDEFLT has not been entered into SYS1.PARMLIB, the initialization program 
writes a message to the console, allowing you to enter SMFDEFLT parameters from 
the console. If the verification program encounters an input/output error while 
reading SMFDEFLT, it writes a message to the console, allowing you to either 
repeat the IPL procedure or enter SMFDEFLT parameters from the console. 


If the initialization program finds SMFDEFLT and reads it without error, each 
parameter is checked for accuracy. If any parameters are incorrectly specified or if 
required parameters are omitted, messages are issued, allowing the operator to 
enter the correct parameter from the console. If all parameters are correctly 
specified and operator intervention is allowed (OPI=YES was specified in 
SMFDEFLT), messages are issued, allowing the operator to examine and modify the 
parameters. 


When the initialization program has completed validation of SMFDEFLT and if SMF 
recording is requested, it checks for the existence of data sets SYS1.MANX and 
SYS1.MANY and for the availability of the devices on which they are defined. The 
initialization routine checks for the availability of the specified device and the 
allocation of the data set on the specified direct access device. 


If an error is found, a message is issued, which indicates that no recording of SMF 
records is allowed until the condition is corrected and the IPL procedure is 
repeated. 


If no errors are found, the initialization routine determines which data set 
(SYS1.MANX or SYS1.MANY) should receive SMF records. If neither data set 
contains data, SYS1.MANX receives the SMF records. 


If one data set contains data and the other one is empty, the partially full data set 
receives the SMF records. If both data sets already contain data, the data set with 
the lesser amount of data receives the SMF records. 


SMF data is maintained in chronological sequence if both SYS1.MANX and 
SYS1.MANY are defined on the same type of device with the same space allocation 
and if the data sets are dumped when called for by the control program. 


When data set verification has been completed without error, the initialization 
routine writes the IPL and input/output configuration records (SMF record types 0 
and 8) to the SMF data set, and gives control to the system so that processing of 
input streams may begin. 


Data Management Procedures 


Space for the SMF data set must be allocated on direct access devices before IPL. 
If possible, a device and channel other than those specified for SYSRES should be 
used. Figure 25 illustrates sample DD statements for allocating space to the SMF 
data set. 


Note: Specification of a secondary space allocation is ignored. 
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SMF Dump Program 


//MANX DD DSNAME=SYS1.MANX, UNIT=190, VOLUME=SER=111111, 
SPACE=( TRK, (20) ),DISP=(NEW,CATLG ) 

//MANY DD DSNAME=SYS1.MANY, UNIT=191, VOLUME=SER=222222, 

// SPACE=( TRK, (20) ),DISP=( NEW, CATLG ) 


Figure 25. DD Statements for Allocating Space for SMF Data Sets 
on Direct Access Devices 


The SMF dump program must be used to transfer full SMF data sets to another 
data set (usually on tape) for analysis and to reset the dumped data set for 
possible reuse as the active SMF data set. Figure 26 shows the JCL required to 
execute the SMF dump program. The output is a non-temporary data set on a 
standard labeled tape. Have the operator record the volume serial number as it is 
needed to reference this data set from another job. It uses the Basic Sequential 
Access Method to perform a physical copy from the input data set, DUMPIN, to 
the output data set, DUMPOUT. In the copy process, the program creates two SMF 
records and writes them to the output data set: a Dump Header record (record 
type 2) at the beginning of the data set and a Dump Trailer record (record type 3) 
at the end of the data set. The SMF dump program also writes messages, as 
required, to SYSOUT. 


/ /DUMPX JOB 201, ,MSGLEVEL=1,PRTY=12 
//STEP1 EXEC PGM=IFASMFDP 
/ /DUMPIN DD DSNAME=SYS1.MANX,DISP=OLD! 


/ /DUMPOUT DD DSNAME=SMFDATA, UNIT=TAPE,DISP=( NEW, KEEP ) 
//SYSPRINT DD SYSOUT=A 


1 If the alternate SMF data set, SYS1.MANY, is being dumped to tape, SYS1.MANY appears in the 
DSNAME parameter. 


Figure 26. JCL for Executing the SMF Dump Program 


When either the SYS1.MANX or SYS1.MANY is filled, a message is written to the 
console requesting a dump. In no case should a data set that is being filled be 
dumped. If the invoked SMF dump program attempts to dump the active SMF data 
set, a message is printed at the console notifying the operator of his error; in 
response, the operator must cancel the dump program. He may then invoke the 
dump program to dump the correct SMF data set. 


The SWITCH command or HALT command can be used to switch between the SMF 
data sets so the previously active data set can be dumped. The format of the 
SWITCH command is: 


{SWITCH {1} SMF 
The format of the HALT command is: 
{HALT |Z} EOD 


When either the SWITCH or HALT command is entered, the following actions 
occur: 


1. A record type 19 is written for each online direct access device if DSV=1 or 
DSV=3 was specified. 


2. A record type 12 is written. 
3. The SMF buffer is written to the SMF data set. 
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4. The SMF data sets are switched or interchanged (that is, a different data set is 
designated to receive SMF records). The previously inactive data set is 
designated to receive SMF records and the previously active data set is 
unavailable for recording. 


Both the SWITCH and HALT commands cause the CPU wait time and system 
Statistics accumulated up to the time of the command to be recorded in record 
type 12. Thus, record type 12 contains the wait time and system statistics 
accumulated from the expiration of the ten-minute time interval reflected in the 
last record type 1 to the time of the SWITCH command or HALT command. The 
next record type 1 contains the wait time and system statistics accumulated from 
the SWITCH command or HALT command to the expiration of the next ten-minute 
time interval. 


The HALT command also causes other system actions, which are described in 
Operator’s Library: OS/VSI1 Reference, GC38-0110, and Operator’s Library: 
OS/VS2 Reference, GC38-0210. The SWITCH command causes only the actions 
described here. 


You may enter jobs specifying execution of the dump program into the system and 
hold them on the job queue until a dump is required. You may then release the 
appropriate job to dump the specified data set. Another method for executing the 
dump is to start a reader to an input stream containing the JCL for the dump 
program. A high priority should be assigned to the dump job to ensure immediate 
Initiation. 
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Report Programs 


Sorting SMF Records 


Producing a report usually requires at least two operations: sorting the SMF 
records and writing them in an appropriate format. Your installation’s requirements 
will determine what further analysis of SMF data is necessary. 


You may use the operating system sort/merge program product, number 5734-SMI, 
to sort SMF records. Note, however, that sort/merge will not process user records 

that are less than 18 bytes long. Your report format and analysis requirements will 
determine the fields on which to sort and will determine the sorting sequence. Sort 
exit E15 allows you to extract or delete selected records as the SMF dump data set 

is sorted, and sort exit E35 allows you to insert records into the final sorted output 
data set. 


Sample Sort/Merge Exit Routines 


Two sample sort/merge exit routines are provided in SYS1.ASAMPLIB: an E15 exit 
routine (called SMFE15) and an E35 exit routine (called SMFE35). The SMFE15 
routine is designed for use with SMFE35. 


The SMFE15 routine extracts all non-job oriented SMF records (that is, records 
without a job log number) from the SMF dump data set. Dump header and dump 
trailer records (SMF record types 2 and 3) are retained in a temporary data set 
(DD name HDRDATA), and all other system-oriented records are retained on 
another temporary data set (DD name SORDATA). Only job-oriented records (that 
is, records having a job log number) are sorted. 


The SMFE35 routine places in the sort output data set all records extracted by the 
SMFE15 exit routine. The system-oriented records precede the sorted job-oriented 
records in the output data set and are inserted in the following order: dump header 
records, dump trailer records, and all other system records. 


An example of the JCL required to execute the sort/merge program is provided in 
the SYS1.ASAMPLIB member named SMFSORT. Figure 27 shows JCL that can be 
used to obtain a listing of sample sort exit routines and of sample sort JCL from 
SYS1.ASAMPLIB. 


If you plan to include the sample exit routines in your sort application, you must 
assemble and link-edit them before executing the sort/merge program. Figure 28 
shows JCL that can be used for this procedure, including one possible sort 
application. In this example, SMF records are to be sorted first on the job log 
number (major control field), then on the date and time portions of the time 
stamp (minor control fields). Displacements of these fields (from the beginning of 
the physical record) are 19, 11, and 7 bytes, respectively. 


For a description of the cataloged procedure ASMFCL (assemble and link-edit) 
refer to OS/VS Assembler Programmer’s Guide, GC33-4021. For a detailed 
discussion of the sort/merge program you may refer to Sort/Merge, SM/1, 
Programmer’s Guide, S$C33-4007. 
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Designing a Report Program 
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The basic operations of a report program are formatting and printing data from 
SMF records. The input to a report program is normally the sorted SMF data set. 
Your installation’s report requirements will determine the amount of data 
modification, analysis, and formatting your report program must perform. 


A sample source report program (SMFFRMT), written in PL/I-F, is provided in 
SYS1.ASAMPLIB. Figure 29 illustrates sample output from the SMFFRMT program. 
This program can also be used to print selected types of SMF records. To do so, 
specify the record types, separated by commas, in the PARM field of the EXEC 
statement. If you want to print all record types, the PARM parameter is not 
required. 


Before using SMFFRMT, you must compile the program using the PL/I compiler. 
Figure 30 shows JCL required to use SMFFRMT after it has been compiled and 
linkedited into SYS1.LINKLIB. 


//PRINT JOB 123456,SMITH 
a EXEC PGM=IEBPTPCH 
//SYSPRINT DD SYSOUT=A 
//SYSUT1 DD DSNAME=SYS1.ASAMPLIB,DISP=(OLD,KEEP), 
Sif UNIT=XXXX , VOLUME=SER=XXXXXX! 
J/SYSUT2 DD SYSOUT=A 
//SYSIN DD * 
PRINT TY PORG=PO , MAXNAME=4 , MAXFLDS=4 
MEMBER NAME=SMFSORT 
RECORD FIELD=( 80 ) 
MEMBER NAME=SMFE15 
RECORD FIELD=( 80 ) 
MEMBER NAME=SMFE35 
RECORD FIELD=( 80) 
/ * 
1 The volume and unit parameters depend on your installation’s request; check with your system 
programmer. 


Figure 27. JCL for Obtaining a Listing of Sample Sort Exit Routines 
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//SMFSORT JOB MSGLEVEL=1 
//STEP1 EXEC ASMFCL! 
//ASM.SYSIN DD * 

E15 SOURCE DECK 


/* 
//LKED.SYSLMOD DD DSNAME=SMF1.EXITS, UNIT=2314,? 
// DISP=( NEW, KEEP ), SPACE=( TRK,(10,5,1)), 


Tf VOLUME=SER=23 1400 
//LKED.SYSIN DD * 
NAME Bele Ro)? 

/* 

//STEP2 EXEC ASMFCL! 

J//ASM.SYSIN DD * 

E35 SOURCE DECK 

/* 

//LKED.SYSLMOD DD DSNAME=SMF1.EXITS,DISP=( OLD,KEEP) ,2 

/ UNIT=2314, VOL=SER=2 31400 

//LKED.SYSIN DD * 

NAME E35(R)3 

/* 

//SORTSTEP EXEC PGM=SORT,REGION=100K4 

//SYSOUT DD SYSOUT=A 

//SORTLIB DD DSNAME=SYS1.SORTLIB,DISP=SHR 

//EXITLIB DD DSNAME=SMF1.EXITS,DISP=(OLD,KEEP),5 

fi UNIT=2314, VOL=SER=231400 

//SORTIN DD UNIT=2400, VOLUME=SER=SYSMAN , DISP=OLD, 6 

LABEL=( ,NL),DCB=( RECFM=VBS, LRECL=600, BLKSIZE=200 )7 

//SORTWKO1 DD UNIT=2314,SPACE=( TRK,(50),,CONTIG)8 

//SORTWKO2 DD UNIT=2314,SPACE=( TRK,(50),,CONTIG )8 

//SORTWKO3 DD UNIT=2314,SPACE=(TRK,(50),,CONTIG)8 

//SORTOUT DD UNIT=2400,DSNAME=SMF1.SORTOUT, LABEL=( ,NL),? 

DISP=( , KEEP ), DCB=( RECFM=VBS , LRECL=600, BLKSIZE=200 )? 

//SORDATA DD UNIT=SYSDA,SPACE=(CYL,(1,1)),!° 

// DCB=( RECFM=VBS, LRECL=600, BLKSIZE=200 )7 

//HDRDATA DD UNIT=SYSDA,SPACE=(TRK,(5,5)),!9 

/ DCB=( RECFM=VBS , LRECL=600, BLKSIZE=200 )7 

J//SYSIN DD * 

SORT FIELDS=(19,16,A,11,4,A,7,4,A),FORMAT=BI,SIZE=E4000!1 
MODS) E15=(E15,700,EXITLIB,N),E35=(E35,1500,EXITLIB,N )!! 
END 

/* 

| EXEC statement for cataloged procedure ASMFCL (assemble and link-edit). 

2 The sample sort exit routines will be link-edited into data set SMF1.EXITS. 

3 Linkage editor control statements specifying that E15 and E35 will be the load module names of 
the exit routines. 

4 EXEC statement for the sort/merge program. 

5 Data set SMF1.EXITS is specified as the library in which sort exit routines may be found. 

6 Input to the sort program is the SMF dump data set, contained on a tape having a volume serial 
number of SYSMAN. 

7 The LRECL value may be larger than the BLKSIZE value because records may be spanned. The 
LRECL value must be as large as the longest SMF record being created plus four bytes for the 
RDW. The BLKSIZE must be equal to one half the SMF parameter BUF. You are expected to 
modify these parameters according to your buffer size and the longest record collected. 

8 Three sort work units are defined as being direct access devices. 

9 The sort output data set is to be written on tape. 

10 Two data sets required by the sample sort exit routines are defined on direct access devices. 

11 The sort/merge control statements define the sort control fields and exit routines to be used in 
this sort application. 


Figure 28. Sample Sort Procedure 
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RECORD HEADER/RECORD DATE 720117 

TYPE PAGE 1 

02 0102 00681590 0072017F C2C2 F4F5 ag Galea eaten BBE aS * 

08 0108 O066D2E5 0072017F C2C2 F4F5 *.. ..KV .... BB 45 * 
002E 082300090802000D0808000E0808000F2008023020080231200802 Wo ds. Jodie Gana e ah ici o a noas aati * 

322008023 3200802 3420080235 20080236 © ocpictaiy Sie Nae ue * 

01 0101 O066D2E8 0072017F C2C2 F4FS *.. ..KY .... BB 45 * 
0000602C 0066D2E8 00000000 00000000 00000000 Wi bh, aR geGes aie” mele’ * 

13 010D 0066D32F 0072017F C2C2 F4F5 *.. ..L. .... BB 45 * 
002E 000040000001404040404040404040404040404040C1 01020000 Bde sham. ane A ....* 
000340404040404040404040404040C1D1D4 *., AJM * 

a 

10 010A 00672333 0072017F C2C2 F4F5 Msc hice! adie BBOAS * 
4040404040404040 00000000 00000000 4040404040404040 0006 * phen ash * 

0801000C * ‘ 

05 0105 00677297 0072017F C2C2 F4FS #2. 00... .... BB 45 * 
CICIDIE2F5F6C1FO 00672FFE 0072017F 0000000000000000 01 TAA TS SONG: sale ieee eee * > 
006769F5 0072017F 00000000 0000 06 00673036 0072017F © oo toh Wwodar sony oatutees metas 
00 8000000000 00 0801 C1 00 00000000000000000000000000 Re Secon cea SNe spat Aletta * 

000000000000 2E D7C5D5C3C540D1E6404040404040404040404040 Moe aes . PENCE JW * 
000173 O01 15 F7F6FOFIFOF1F3F 1F6F2FOF2F7DSFOF2F 2D7D9D6C4 * 7601013162027NO22PROD * 

06 0106 006774D1 0072017F C2C2 F4F5 #2. ...0 .... BB 45 * 
CICIDIF2F5F6C1FO 00672FFE 0072017F oO0CO0000000000000 cr) #DAISSGAO 2... cece cee eee A * 

00677408 0072017F 00000008 00 01 40404040 Dara: eek * 

05 0105 OO67AE1F 0072017F C2C2 F4F5 #2. 00... 2... BB 45 * 

CICIDIE2F5F6C2FO 00677F2F 0072017F 0000000000000000 01 *DAISS6OBO 1... cee cee ee eee * 
00678298 0072017F 00000000 0000 06 00677F68 0072017F Wcdevie cellcn. cthuba ae A urate, aaa 
00 8000000000 00 0801 C1 00 00000000000000000000000000 ate ee Sear re * 
000000000000 2E D7C5D5C3C540D1E6404040404040404040404040 east Oe, . PENCE JW * 

00031C O01 15 F7F6FOFIFOF1F3F1F6F2FOF2F7D5FOF2F2D7D9D6C4 * 7601013162027NO22PROD * 

06 0106 0067B073 0072017F C2C2 F4F5 #2000... 0... BB 45 * 
CICIDIE2FS5F6C2FO 00677F2F 0072017F O000000000000000 cr) *#DAJSSOBO 0... cee. cece eee A * 

OO67AF96 0072017F 00000008 00 01 40404040 Wi ees * 
12 010C 0067B81A 0072017F C2C2 F4F5 Ps. caged, aoe ah. BBS * 
O00009B2F O0067B7FF 0000051A O00005BF 00000002 Wt sash sek gre aes aot * 
03 0103 0068161A 0072017F C2C2 F4F5 2.00... .... BB 45 * 
Figure 29. Sample Output from SMFFRMT Program 
/ /FORMAT JOB 123456,SMITH d 
//ERMT EXEC PGM=SMFFRMT, PARM='1,2,3,5,6,8,9,10,11,12,13' 
//SYSPRINT DD SYSOUT=A 
//REPORT DD SYSOUT=A,DCB=( RECFM=VBA, BLKSIZE=3500 ) 
//SMFDATA DD DISP=(OLD,KEEP ), LABEL=( ,NL), VOL=SER=XXXXXX,! 
// UNIT=2400 , DCB={ RECFM=VBS , BLKSIZE=1000 )2 
1 The tape volume serial number replaces the X’s. 
2 The BLKSIZE is one-half the value specified as the SMF IPL parameter BUF. For this example, 
BUF is equal to 2,000. 
Figure 30. Sample JCL to Run SMFFRMT 
& 
v 
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Exit Routines 





This chapter contains information for planning and writing exit routines. It 
describes: 


e Exit routine facilities and restrictions, including information on communication 
among user written exit routines; parameters passed to exit routines; the 
SMFWTM macro instruction, which can be used by exit routines to write a record 
to the SMF data set; and the IFASMFR macro instruction, which can be used to 
symbolically address fields in SMF records. 


e Exit routines, including a full description of each of the sample SMF exit routines. 


Figure 31 shows the exits available in each system. 


IEFUIV Yes 


1 In VS2 systems, this exit is available only when HASP is in the system. 


Figure 31. Exits Available in Each System 


Exit Routine Facilities and Restrictions 


The functions performed by your exit routines are determined solely by the 
requirements of your installation. The following paragraphs describe exit routine 
restrictions, formats of parameters passed to each exit, and the required return 
codes. Sample Assembler language exit routines for some exits are provided ina 
member (SMFEXITS) of SYS1.ASAMPLIB. Figure 32 shows the JCL required to 
retrieve a listing of these sample routines. 


//PRINT JOB 123456,SMITH 

// EXEC PGM=IEBPTPCH 

//SYSPRINT DD SYSOUT=A 

//SYSUT1 DD DSNAME=SYS1.ASAMPLIB,DISP=(OLD,KEEP), 

UNIT=XXXX , VOLUME=SER=XXXXXX! 

//SYSUT2 DD SYSOUT=A 

//SYSIN DD: —* 
PRINT TYPORG=PO0O , MAXNAME=1 , MAXFLDS=1 
MEMBER NAME=SMFEXITS 

’ RECORD FIELD=( 80 ) 

x 


1 The volume and unit parameters depend on your installation’s request; check with your system 
programmer. 


Figure 32. JCL for Obtaining a Listing of Sample Exit Routines 
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User written exit routines for the exit IEFU83 must be written in re-enterable code. 
All other user written exit routines should be written in re-enterable code, because 
the link edit attributes of the load module are subject to change from release to 
release. All user written exit routines receive control via a BALR. User written exit 
routines must save registers when they receive control and restore registers before 
returning to the control program. Register 13 contains the address of the register 
save area, register 14 contains the return address, and register 15 contains the entry. 
point address. 


Under VS2, all SMF exit routines except IEFU83 can access installation-defined data 
sets. Under VS1, all exit routines except IEFUSO and IEFUTL can access 
installation-defined data sets. 


User written exit routines can communicate with each other via the user- 
communication field and the user-identification field. The user-communication field 
can be used to communicate between exits taken for different jobs. The 
user-identification field can be used to communicate between exits of the same job. 
These fields are passed to every exit routine except IEFU83, which is only available 
in VS2, and are logically part of each job. The user-communication field is initialized 
to binary zeros at reader initialization (starting a reader or restoring a transient 
reader). The user-identification field is initialized to blanks as each new job is read. 


Any exit routine may obtain an additional work area by issuing a GETMAIN macro 
instruction that specifies an appropriate subpool in system queue area. Figure 33 
shows the characteristics of the subpools that can be specified. The address of the 
work area can be placed in the user-communication field. (You must consider the 
storage required by this work area when estimating the size of system queue area.) 


Note: Communication areas obtained by exits are not maintained if the system is 
restarted. 


Subpool Number | Storage Is Allocated Storage Is De-allocated 


245 In system queue area. Explicitly, by issuing a FREEMAIN macro 
instruction. 





253 In partition queue area. | Automatically at end of task. 
254 Automatically at end of step. 


255 In partition queue area. Explicitly, by issuing a FREEMAIN macro 
instruction. 





Note: Only routines having a protection key of 0 can obtain the storage in system queue area (VS1 
or VS2) or high in a partition (VS1). 


Figure 33. Characteristics of Subpools in System Queue Space 
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If an exit routine cancels a job during or after job initiation, a job termination record 
(record type 5) is written to the SMF data set if the writing of records is permitted. 
If you require job cancellation information in the System Output Message Data Set, 
you may pass a message to module IEFYS from the termination exit routine 
IEFACTRT. At job termination time, you can determine if an IEFUJV (VS1 only), 
IEFUJI, IEFUSI, or IEFACTRT exit routine canceled a job, by examining the job 
termination indicators in record type 5. At step termination time, you can determine 
if an IEFUSO (VS1 only) or IEFUTL exit routine canceled a job, by examining the 
step completion code field in record type 4. The system does no recording of jobs 
canceled before job initiation except in VS2 systems with HASP. In VS2 with HASP, 
all jobs read by HASP will cause record type 26 to be generated regardless of when 
the job is canceled. At job purge time, you can determine if the job did not get to 
job initiation by examining the step number in the common exit parameter area for 
zero. In VS1, the only exit before job initiation is IEFUIV; in VS2, the only exit before 
job initiation is IEFUJV. The installation may, however, write a record to the SMF 
data set from these exits when a job is not accepted for processing prior to job 
initiation. 

Your routines can use the SMFWTM macro instruction to write to the SMF data set. 
If you want to use your own data sets, you must define them for VS1, as follows: 


e A data set used by exit routine IEFUIV requires a DD statement in the reader 
cataloged procedure. 


« A data set used by exit routines IEFUJV, IEFUJI, IEFUSI, and IEFACTRT requires a 
DD statement in the initiator cataloged procedure. 


e A data set used by exit routine IEFUJP requires a DD statement in the writer 
cataloged procedure. 


You cannot write to your own data sets from the exit routines IEFUSO and IEFUTL. 
If you want to use your own data sets, you must define them for VS2, as follows: 


« A data set used by exit routine IEFUJP requires a DD statement in the HASP 
cataloged procedure. 


e A data set used by exit routines IEFUJI, IEFUSI, IEFUTL, and IEFACTRT requires a 
DD statement in the initiator cataloged procedure. 


Note: In either VS1 or VS2, user data sets cannot be allocated to SYSOUT. 


Exit Routine Parameters 


When an exit routine receives control, register 1 points to a list of four-byte 
addresses. The first entry in the list is common to all exit routines except IEFU83. 
The first entry points to a parameter area that is 72 bytes long for VS1 when 
SMF=FULL is specified or 36 bytes long for VS2. 


Figure 34 describes the format of the parameter area for VS1. Note that the fields in 
the parameter area are filled in chronologically; therefore, not all fields are 
meaningful for all exits. The first 36 bytes shown in Figure 34 describe the format 
of the parameter area for VS2. 


Figure 35 summarizes the information available to each exit (in addition to common 
exit parameters, described in Figure 34) when each exit is called, and the return 
from each exit to the control program. The names in parentheses are mandatory 
entry-point names that must be assigned. 
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Displacement 
from Pointer 


0 
8 


12 
16 


20 


28 
29 


30 
32 


The following fields apply to 


36 
40 
44 
45 
46 
47 
48 
52 
56 
60 
64 
68 


Field 
Size 
8 

4 


hp hp PR Pe KH Ke He Pa 


Data 
Format 


EBCDIC 


binary 


packed 
decimal 


EBCDIC 
EBCDIC 


binary 


binary 


binary 


binary 


only VSI: 


binary 
binary 
binary 
binary 
EBCDIC 
EBCDIC 
binary 
binary 
binary 
binary 
binary 


binary 


Description 
Job name 


Time, in hundredths of a second, that the reader 
recognized the Jos card for this job 


Date that the reader recognized the JOB card for the 
job, in the form 00YYDDDF, where F is the sign 


System identifier and model identifier (two bytes each) 


User identification field. SMF places this data in all 
subsequent records for this job. This field is initialized 
to EBCDIC blanks for each job.! 


Number of the step being processed 


Eight indicators of SMF options that are selected by the 
user. A bit setting of 1 indicates the related option was 
selected. 


Bit Option 

0 Job accounting 

1 Step accounting 

2 Dynamic exits 

3 Data set accounting 

4 Volume accounting 

5 Reserved 

6 Temporary data set scratch records 
7 0—Background job 


1—Foreground job? 
Reserved 


User communication field. This field is intended to be a 
user exit routine communication field. The reader 
initializes this field to zeros only when the reader is 
started or a transient reader is restored.! 


Real time in reader, in hundredths of a second 
Number of lines read 

Job priority 

Reserved 

Job class 

Reserved 

Real time to print, in hundredths of a second 
Number of SYSOUT lines printed 

Real time to punch, in hundredths of a second 
Number of SYSOUT lines punched 

Real time for tape, in hundredths of a second 


Number of SYSOUT lines written to tape 


1 These two fields are the only fields provided for user modification. 
2 Because TSO does not operate under VS1, bit 7 is always 0 when VS1 is used. 


Figure 34. Common Exit Parameter Area 
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Input Stream 
















Continue or cancel. 





JCL image of JOB When a JOB card is 








f Validation— statement. encountered by 
VS1 only input-stream control. 
(IEFUIV) 





Job Validation 
(IEFUJV) 





JCL image, JCL type. Each JcL card (excluding | Continue or cancel. 
comment statements), 
after all JCL has been 


interpreted. 


Job Initiation Programmer name, Job initiation. Continue or cancel. 
(IEFUJI) priority, account field. 

Step Initiation Step program name, step | Step initiation. Continue or cancel. 
(IEFUSI) name, accounting fields. 


SYSOUT Limit— SYSOUT limit exceeded. Continue with new 
VS1 only limit or cancel. 
(IEFUSO) 








Time Limit Entry type. Job CPU time limit Continue with new 
(IEFUTL) exceeded, step CPU time | time limit or cancel. 
limit exceeded, 
continuous wait time 
limit for the job 
exceeded. 


SMF Record— SMF record to be written. | When a record is to be Write or don’t write 
VS2 only written to the SMF. SMF record to SMF. 
(IEFU83) 











Termination Programmer name, job Step termination, job Continue or cancel; 

(IEFACTRT) CPU time (in hundredths | termination. write or skip SMF 
of a second), job record. 
accounting fields, step 
CPU time (in hundredths 
of a second), step 
accounting fields, 
completion code, SMF 
record. 


Job Purge— Programmer name, job When a job is ready to be 
VS1 only CPU time, number of | purged from the system. 
(IEFUJP) accounting fields in the 

JOB statement, address of 

the accounting 

information. 








Job Purge— SMF record to be written. | When a job is ready to be | Write or skip SMF 
VS2 with purged from the system. | record. 

HASP 

(IEFUJP) 





Figure 35. Exit Routine Characteristics 


SMFEWTM Macro Instruction 


You may use the SMFWTM macro instruction in any routine except IEFU83 that has a 
protection key of 0 to write a record ta, the sMF data set. The macro is supplied on 
SYS1.MACLIB. 


Note: Record types 128 through 255 are available for user written records. 
The format of the SMFWTM macro instruction is: 

[label |] SMFWTM {record address | (r)} 
where: 


record address 
is the symbolic address of the record to be written. 
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() 
is a register containing the address of the record. You may use either the absolute 
register number or a symbolic designation. In either case you must enclose the 
value in parentheses; for example, (2) or (REG2). 


The record to be written should include a standard SMF record header and a record 
descriptor word (RDW). See the first fourteen bytes of record type 6 in the chapter 
‘‘Accounting Records” for the header format. For a discussion of the RDW, refer to 
OS/VS Data Management Services Guide, GC26-3783. 


Note: The sort/merge program product will not process records less than 18 bytes 
long. 


The SMFWTM macro instruction returns a code in register 15, which indicates the 
disposition of the user record as follows: 


e 0, which indicates that the record was written without error. 


e 4, which indicates that the record was truncated, because it would not completely 
fit in an empty SMF data set. 


e 8, which indicates that the record was not written, because the specified length 
was less than five bytes. 


e 12, which indicates that the record was not written, because the routine was not 
authorized to write to the SMF data set. (The requesting routine had a non-zero 
protection key.) 


e 16, which indicates that the record was not written, because (a) the writing of 
records to the SMF data set is prohibited (that is, MAN=NONE was specified in 
SMFDEFLT), or (b) the writing of records is allowed but the SMF data set was 
full. If the SMF data set is full, it must be dumped before additional SMF records 
can be written. (See ‘“‘Operational Considerations” in the chapter ‘“‘System 
Information and Requirements” for the procedure for executing the SMF dump 
program. ) 


e 20, which indicates that the record was not written, because the IEFU83 exit 
specified that the record should not be written (VS2 only). 


IFASMER Macro Instruction 
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You may use the IFASMFR macro instruction in exit routines (or in any problem 
program application) to symbolically address SMF record fields. The macro is 
supplied on SYS1.AMODGEN. 


The format of the IFASMFR macro instruction is: 
[label | IFASMFR [n }[, SUBSET1][,SUBSET2] 

where: 

n 
is the record type to be defined. If more than one record type is specified, the 
record types must be enclosed in parentheses and separated by commas. The 
values of n for VS1 can be 0-15, 17-21, 43-45, 47-49, 62, 64, 68, or 69. The 


values of n for VS2 can be 0-15, 17-21, 26, 30-35, 40-42, 43, 45, 47, 48, 63, 64, 
68, or 69. 


SUBSETI1 
specifies that record types 0-13 are to be defined. 


SUBSET2 
specifies that record types 14 and 17-21 are to be defined. 
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Because of the similarity of record types 14 and 15, whenever record type 15 is 
specified, record type 14 is defined. Therefore, record types 14 and 15 cannot both 
be specified in one program using the IFASMFR macro instruction. If both are 
specified, a multiple definition of record type 14 is produced. 


Note: You must enter at least one of the parameters with the IFASMFR macro 
instruction. If required, a CSECT or DSECT statement must be supplied ahead of the 
macro instruction. 


VS1 and VS2 Exit Routines 


The exits available for user written routines in both VS1 and VS2 are fully described 
in the topics that follow. 


IEFUJV—Job Validation Exit 


The IEFUJV exit can be taken from both the background and the foreground. IEFUJV 
receives control just before each JCL 80-character image (other than comment 
statements) for a job is interpreted and after all JCL images have been interpreted. 


A user written routine entered at this exit might do any or all of the following: 


e Validate any account fields included in the JOB and EXEC statements by 
comparison with a standard list. 


e Validate or assign the priority. 
e Validate or assign the REGION request. 
e Validate or assign job time and job step time parameters. 


e Control output stream data by assigning a SPACE parameter to SYSOUT 
statements. 


e Check for authorization to use data sets. 
« Create installation-defined accounting records. 


« Assign the user-identification field to be included in SMF termination records and 
the SYSOUT records for the job. 


Depending on the processing you want to perform, it may be more efficient to check 
JOB and EXEC statement accounting fields at the exits provided for job initiation and 
the first job step initiation, respectively. The fields are passed as parameters to those 
routines, making a statement scan routine unnecessary. You may assign user 
identification at either of these exits and may write messages to the system output 
message data set from the IEFACTRT exit routine. 


Note: The user-communication field is initialized to binary zeros when the reader is 
started or a transient reader is restored. Data placed in this field by the IEFUJV exit 
routine will become part of each job when it is enqueued and will be accessible by 
exit routines (except IEFU83) entered in processing each job. Data placed in the field 
by the IEFUJV exit routine will be the same the next time this exit routine is entered 
unless a new reader is started or a transient reader is restored. 


At entry to the routine, register 1 points to a list of four-byte addresses, as follows: 
1. The address of an exit parameter area. (See Figure 34.) 


2. The address of an 80-character JCL statement image (in EBCDIC). JCL statements 
are identical to those listed in the SYSOUT data set; control statements containing 
only comments, however, are not made available. If a cataloged procedure is 
being executed, it is expanded before this exit routine receives control; the 
sequence of statements is JOB, EXEC PROC=..., EXEC PGM=..., followed by the 
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other statements of the procedure. Override statements immediately precede the 
statement being overridden. 


3. The address of a one-byte area that indicates the type of JCL statement being 
presented to the exit routine. The indicator will have one of the following binary 
values: 


0, which indicates a null statement. 

1, which indicates a JOB statement. 

2, which indicates an EXEC statement. 

4, which indicates a DD statement.! 

8, which indicates a PROC statement (for symbolic parameter definition). 


16, which indicates that no statement is being presented and that all JCL images 
have been passed to the exit. 


The job validation routine may test and modify any of the operand fields in the job 
control statements and indicate, through a return code passed to job management, 
whether processing of this job is to continue. If the user modifies a job control 
statement, the modified statement is passed to the interpreter for processing. The 
modified statement appears in the SYSOUT listing. 


Editing of the job control statements must not result in additional job control 
statements or continuation cards. Operand fields being added must not precede the 
first operand of any JCL statement image. 


Before the IEFUJV exit routine returns to the control program, it must place a return 
code in register 15. A value of 0 indicates that processing of the job should 
continue; a binary value of 4 indicates that the job is to be canceled. A job canceled 
at this exit in VS1 causes the job initiation records not to be written. A job canceled 
at this exit in VS2 causes all SMF records not to be written. 


Note: In VS2, the SMF data set will not contain any record of jobs not accepted by 
this exit unless the user written exit routine writes it. 


Sample IEFUJV Routine 


The sample IEFUJV exit routine provided in the member SMFEXITS of 
SYS1.ASAMPLIB checks the validity of a continued JOB statement and of values 
supplied for REGION, PRTY, TIME, and accounting parameters in JOB statements, 
Characters from the account number are used to index a table that contains 
allowable values for these parameters. If any value is found to be invalid, the job is 
terminated. 


IEFUJI—Job Initiation Exit 
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The IEFUJI exit can be taken from both the background and the foreground. IEFUJI 
receives control just before each job is initiated. 


The job initiation exit may be used to change job priority and to validate job 
accounting information. 


1 The two high-order bits of the byte that indicates that this isa DD statement have the following 


meanings: 

Bit Meaning When Set 

0 An out-of-sequence DD statement 

1 A misplaced SYSCHK DD statement 
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Sample IEFUJI Routine 


At entry to the routine, register 1 points to a list of four-byte addresses, as follows: 
1. The address of an exit parameter area. (See Figure 34.) 


2. The address of a 20-byte area containing the programmer’s name (in EBCDIC) 
from the JOB statement. This area is aligned left and, if necessary, padded with 
blanks. 


3. The address of a one-byte area indicating the requested job priority. 


4. The address of an area containing accounting information from the JOB 
statement. If the JOB statement contains no accounting information, the area is 
one byte of zeros. 


The accounting fields are placed in a formatted list for easy access. Figure 36 shows 
the format of the accounting information that is available to IEFUJI. 


Decimal Hexadecimal Field Data 
Displacement Displacement Size Format Contents 
0 0 1 binary Number of accounting fields in 
statement (0 for no fields) 
1 1 Consecutive accounting fields! 


— 


Each entry for an accounting field contains the length of the field (one byte, binary), followed by 
the field (variable length, EBCDIC). The entry for a null accounting field contains a length of 
zero. (Null accounting fields are indicated by consecutive commas in the accounting field of a 
JOB statement.) 


Figure 36. Format of Accounting Information 


If the installation uses major and minor account numbers with several fields, this exit 
is easier to use for account number processing than IEFUJV is because of the 
formatted list. 


Before the IEFUJI exit routine returns to the control program, it must place a return 
code in register 15. A value of 0 indicates that processing of the job is to continue; a 
binary value of 4 indicates that the job is to be canceled. A job canceled at this exit 
causes the job initiation record not to be written. 


The sample IEFUJI exit routine provided in the member SMFEXITS of 
SYS1.ASAMPLIB determines how long a job has been in the input job queue before it 
is initiated, This value and the job priority are written to the SMF data set as a user 
record. 


IEFUSI—Step Initiation Exit 


The IEFUSI exit can be taken from both the background and the foreground. IEFUSI 
receives control just before each job step is initiated, prior to allocation. (If OPT=1 
was specified in the SMFDEFLT data set, this exit is not taken.) 


The step initiation exit may be used to validate job step accounting information and 
to write to an installation data set. 
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At entry to the routine, register 1 points to a list of four-byte addresses, as follows: 
1. The address of an exit parameter area. (See Figure 34.) 


2. The address of an eight-byte area containing the job step name (in EBCDIC) from 
the EXEC statement. This area is aligned left and, if necessary, padded with 
blanks. 


3. The address of an eight-byte area containing the program name (in EBCDIC) from 
the EXEC statement. This area is aligned left and, if necessary, padded with 
blanks. 


4. The address of an area containing step accounting information from the EXEC 
statement. This area has the format shown in Figure 36. 


Before the IEFUSI exit routine returns to the control program, it must place a return 
code in register 15. A value of 0 indicates that processing of the job should 
continue; a binary value of 4 indicates that the job is to be canceled. 


No sample IEFUSI exit routine is provided in SYS1.ASAMPLIB. 
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The IEFUTL exit can be taken from the background only. IEFUTL receives control 
when one of the following time limits expires: 


e The job CPU time limit (from the JOB statement). 
« The step CPU time limit (from the EXEC statement or reader procedure). 
e« The continuous wait time limit for the job (from SMFDEFLT). 


If a job time limit is specified on the JOB statement, the limit for each step will be 
set to job step time limit (selected from the TIME value coded on the EXEC 
statement or time limit in the reader procedure) or the remaining job time, 
whichever is smaller. 


If no time limit is specified on the JOB statement, each job step is timed individually 
by using the TIME value from the EXEC statement or the time limit value from the 
reader procedure. 


Specifying TIME=1440 on the JOB statement eliminates all timing for the job. 
Specifying TIME=1440 on the EXEC statement without a JOB time limit specification 
eliminates job step timing for the step. 


The time limit exit can be used to control and record time expirations. For example, 
you may use this exit to inform the operator that a job has exceeded the continuous 
wait time limit and request a reply to cancel the job or extend the time limit. 


The asynchronous exit interface routine sets a step must-complete status before SMF 
installation exit IEFUTL is given control. Consequently, the system will become 
interlocked in VS2 or the initiator will abnormally terminate in VS1 if the exit 
enqueues on a resource already enqueued on by the job step task or any of its 
subtasks. This enqueue can come from within SVCs, for example, the SMFWTM and 
WTO macros. 


At entry to the routine, register 1 points to the address of an exit parameter area. 
(See Figure 34.) Register 0 will have one of the following binary values: 


¢ 0, which indicates that the job CPU time limit expired. 
e 4, which indicates that the job step CPU time limit expired. 


e 8, which indicates that the continuous wait time limit for the job expired. 
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Sample IEFUTL Routine 


Before the IEFUTL exit routine returns to the control program it must place a return 
code in register 15. A value of 0 indicates that the job is to be canceled; a binary 
value of 4 indicates that the job is to continue processing with an additional time 
allocation. The additional time (in timer units) must be placed in register 1. The 
number of timer units is determined by the following algorithm: 


1 second=38400 timer units 


The exit routine should control the number of extensions for a given job to prevent 


looping. It may record the expiration in the SMF data set or as a message to the 
console. It may not record the expiration in an installation-defined data set. 


Note: Time can be extended only within a step. When the step is completed, the 
next step will never be started if the total job CPU time used is greater than the job 
CPU time limit including the extension. Also, be sure to return control in the 
supervisor state with a protect key of 0. 


The sample IEFUTL exit routine provided in the member SMFEXITS of 
SYS1.ASAMPLIB causes a job to be terminated if the job CPU time limit or job step 
CPU time limit has been exceeded. If the continuous wait time limit for the job has 
been exceeded, the limit is extended twice; on the third entry for exceeding the 
continuous wait time limit for the job, the job is canceled. Each time the routine is 
entered for an exceeded job wait time limit, it writes a record to the SMF data set 
describing the action taken. 


IEFACTRT—Termination Exit 


The IEFACTRT exit can be taken from both the background and the foreground. 
IEFACTRT receives control when execution of a job or job step is terminated.' (If 
OPT=1 was specified in the SMFDEFLT data set, this exit is taken only at job 
termination.) 


The termination exit may be used to perform your own unique accounting functions. 
At entry to the routine, register 1 points to a list of four-byte addresses, as follows: 


1. The address of an exit parameter area. At entry for job termination the 
parameter at displacement 28 contains the number of steps in the job. (When 
SMF=BASIC is specified, this field contains the address of the jobname.) 


2. The address of an eight-byte area containing the job step name (in EBCDIC). 
This area is aligned left and, if necessary, padded with blanks. At job 
termination the address is zero. 


3. The address of a 20-byte area containing the programmer’s name (in EBCDIC). 
This area is aligned left and, if necessary, padded with blanks. 


4. The address of a four-byte area that contains, in the first three bytes, 
accumulative job CPU time in hundredths of a second (a binary value). The 
last byte contains the number (binary) of accounting fields in the JOB 
statement. 


5. | The address of an area that contains accounting information from the JOB 
statement. This area has the format described earlier in Figure 36, excluding 
the first field shown (the number of accounting fields). If the JOB statement 
contains no accounting information, the area contains one byte of zeros. 


1 TEFACTRT also receives control at allocation time when SMF=BASIC is specified. 
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6. The address of a four-byte area that contains, in the first three bytes, step CPU 
time in hundredths of a second (a binary value). The last byte contains the 
number (binary) of accounting fields in the EXEC statement. At job 
termination the address is zero. 


7. The address of an area that contains accounting information from the EXEC 
statement. This area has the format described earlier in Figure 36, excluding 
the first field shown (the number of accounting fields). If the EXEC statement 
contains no accounting information, the area contains one byte of zeros. At 
job termination the address is zero. 


8. The address of a two-byte area. The first byte is an indicator: if bit 7 is set to 
1 when the exit routine is entered, the job has been canceled; if the exit 
routine sets bit 7 to 1, the job will be canceled. The second byte contains the 
number of the job step currently being processed. At job termination, this 
second byte contains the number of steps in the job. 


9. The address of a two-byte area containing the termination status (condition or 
completion code) of the job or job step. (When SMF=BASIC is specified, this 
field does not exist.) 


10. The address of an area containing a four-byte record descriptor word (RDW) 


immediately followed by the job step termination record (record type 5) to be 
written to the SMF data set. (When SMF=BASIC is specified, this field does not 
exist. ) 


At entry to the routine, register 0 contains a binary code indicating the reason for 
entry; a value of 12 indicates job step termination, and a value of 16 indicates job 
termination. 


Output from IEFACTRT may be directed to the console or to SYSOUT. Under SMF, 
installation information may be written either to the SMF data set or to an 
installation-supplied data set. 


If your IEFACTRT exit routine writes messages for system output, the contents of 
register 12 must be the same as when the routine was entered, and register 13 must 
contain the address of a 45-word work area. Figure 37 shows the technique that 
must be used when IEFACTRT writes to the System Output Message Class. 


MVC 36(4,12),MSGADDR MOVE MESSAGE ADDRESS AND 


MVC 42(2,12),MSGLEN LENGTH TO SYSTEM TABLE 
L REG15,VIEFYS BRANCH AND LINK TO MESSAGE 
BALR REG14,REG15 ROUTINE 

MSGADDR DC A( MSG ) 

MSG DC C'message text' 

MSGLEN DC H'xx' MESSAGE LENGTH 

VIEFYS DC V( LEFYS ) 


Figure 37. Writing System Output Messages from IEFACTRT 


Before the IEFACTRT exit routine returns to the control program, it must place 
return codes in registers 1 and 15, as follows: 


¢ If register 1 contains a value of 4, the termination record is not to be written to 
the SMF data set; if it contains a value other than 4, the termination record is to 
be written. 


« If register 15 contains a value of 4, the remaining job steps are to be canceled; if 
it contains a value other than 4, processing is to continue. 
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Sample IEFACTRT Routine 


[EFUJP—Job Purge Exit 


The sample IEFACTRT exit routine provided in the member SMFEXITS of 
SYS1.ASAMPLIB changes the SMF job termination and job step termination records 
(unless the job step is flushed) to user records and attempts to write them to the 
SMF data set. If the data set is full, a message indicating lost SMF records is written 
to the console. At job termination a record containing the job name, programmer’s 
name, and account number is written to the SYSOUT device. 


IEFUJP receives control when a job is ready to be purged from the system, that is, 
after the job has terminated and all the SYSOUT output that pertains to the job has 
been written. IEFUJP is available only when VS1 or HASP in a VS2 system is used. 


The VS1 job purge exit can be used, for example, to write additional data statistics 
found in the common exit parameter area to the SMF data set by using the SMFWTM 
macro instruction. In VS2 with HASP, the job purge exit may be used to summarize a 
job’s activities in the system. 


In VS1, at entry to the routine, register 1 points to a list of four-byte addresses, as 
follows: 


1. The address of the 72-byte exit parameter area. (See Figure 34.) (When 
SMF=BASIC is specified, this field contains zeros.) 


2. Reserved. 


3. The address of a 20-byte area containing the programmer’s name (in EBCDIC). 
This area is aligned left and, if necessary, padded with blanks. 


4. The address of a four-byte area that contains, in the first three bytes, job CPU 
time in hundredths of a second (a binary value). The last byte contains the 
number (binary) of accounting fields in the JOB statement. 


5. The address of the job accounting information. 


In vS2 at entry to the routine, register 1 points to a list of four-byte addresses, as 
follows: 


1. The address of an exit parameter area. (See Figure 34.) 


2. The address of an area containing the job purge record (record type 26) to be 
written to the SMF data set. 


In VS1, IEFUJP does not return a code to the control program. 


In VS2, before the IEFUJP exit routine returns to the control program, it must place a 
return code in register 15. A value of other than 4 indicates that the purge record is 
to be written to the SMF data set; a value of 4 indicates that the purge record is not 
to be written. 


No sample IEFUJP routine is provided in SYS1.ASAMPLIB. 


VS1-Only Exit Routines 


The exits available for user written routines in only VS1 are fully described in the 
topics that follow. 
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IEFUIV—Input Stream Validation Exit 


IEFUIV receives control when the input-stream control routine encounters each 
80-character logical record of a JOB statement. IEFUIV is available only when VS1 is 
used. 


The input stream validation exit may verify that the JOB statement is correct and 
acceptable for processing. This routine may also modify any of the fields in the JOB 
statement. 


At entry to the routine, register 1 points to a list of four-byte addresses, as follows: 
1. The address of the 72-byte exit parameter area. (See Figure 34.) 
2. The address of an 80-character logical record of a JOB statement. 


Before the IEFUIV exit routine returns to the control program, it must place a return 
code in register 15. A value of 0 indicates that the job is to be accepted for 
processing; a binary 4 indicates that the job is not acceptable for processing. 


Note that the SMF data set will not contain any record of jobs not accepted by this 
exit routine unless the user written exit routine writes it. 


No sample IEFUIV routine is provided in SYS1.ASAMPLIB. 


IEFUSO—SYSOUT Limit 


VS2-Only Exit Routine 


The IEFUSO exit can be taken from the background only and is available only when 
VSI is used. IEFUSO receives control when the output limit is reached in an 
SMF=FULL or SMF=BASIC system. The output limit is specified by the OUTLIM 
parameter on the DD statement or defaults to the OUTLIM parameter value of the 
JES system generation macro instruction. The OUTLIM function limits output to 
spooled data sets; it does not apply to direct SYSOUT data sets. The function is 
described in OS/VS JCL Reference, GC28-0618 and OS/VSI Job Management 
Logic, SY24-5161. 


Note: The IEFUSO exit is not controlled by the EXT parameter. 


The SYSOUT limit exit may monitor the amount of output written to spooled data 
sets. It cannot write to installation-defined data sets. 


At entry to IEFUSO, register 1 points to a list of four-byte addresses, as follows: 


1. The address of the 72-byte exit parameter area. (See Figure 34.) (When 
SMF=BASIC is specified, this field contains zeros.) 


2. The address of the DCB for the data set. 


Before the IEFUSO exit routine returns control to the control program, it must place 
a return code in register 15. A value of 0 indicates that the job step is to be 
terminated; a binary value of 4 indicates that the output limit is to be increased by 
the value placed in register 1 and processing is to continue. 


Note: Unless the output limit has been increased, the exit to the user written routine 
will again be taken when the next record is written to this SYSOUT data set. 


No sample IEFUSO exit routine is provided in SYS1.ASAMPLIB. 


The exit available for user written routines in only VS2 is fully described in the topic 
that follows. 
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IEFU83—SMF Record 


Sample IEFU83 Routine 


Testing Exit Routines 


IEFU83 receives control when each SMF record is ready to be written to the SMF data 
set. When IEFU83 is active (that is, when EXT=YES is specified), any module 
requesting the writing of an SMF record must have 84 bytes in its area because 
SVC83 issues a GETMAIN for 84 bytes in which to build a parameter list. [EFU83 is 
available only when VS2 is used. This exit must be written in re-enterable code 
because the routine runs under different storage protect keys. 


This exit can be used to select the records to be written or to act on the occurrence 
of a given record. An example of the latter is asking the operator the reason for an 
IPL whenever an IPL record is to be written. 


At entry to the routine, register 1 points to a four-byte address, which points to the 
RDW of the SMF record to be written. 


Before IEFU83 returns control to the control program, it must place a return code in 
register 15. A value of O indicates that the record is to be written to the SMF data 
set; a value of 4 indicates that the record is not to be written. 


Output from IEFU83 may be directed to the console. It cannot be directed to an 
installation-supplied data set. 


The sample IEFU83 exit routine supplied in the member SMFEXITS of 
SYS1.ASAMPLIB examines the record to be written. If the record to be written is an 
IPL record, IEFU83 writes to the operator with a reply request for the record types to 
be written. If the record is not an IPL record, the return code depends upon the 
records currently requested. 


The sample IEFU83 routine has a special macro definition for ‘‘write to operator with 
reply’’ so that output normally directed to the operator is suppressed and a standard 
reply is assumed for testing with TESTEXIT. This macro should be removed if you 
want the message printed at the console. The sample routine also has special macro 
definitions for “write to operator” and “‘wait”’, which generate no-op instructions. 


Note: For VS2 release 1.6 and later releases, you will want to suppress writing of 
VSAM record types 63 and 67 to the SMF data set, if you do not plan to use them for 
VSAM catalog recovery. The reason is that these records take up a considerable 
amount of space on the SMF data set. 


Because the exit routines provided by your installation will become a part of the 
control program, you must test them thoroughly. A test procedure (TESTEXIT) is 
provided in SYS1.ASAMPLIB to aid in your testing. 


Special Requirements for Testing Exit Routines 


For testing purposes only, your exit routines must conform to the following 
requirements. 


e A user subpool (0-129) must be specified in GETMAIN macro instructions. (When 
testing is completed, one of the subpools shown in Figure 33 must be specified 
for the area used to communicate between exit routines.) 
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e If the SMFWTM macro instruction is used in any of your routines, you must 
provide a special macro definition in the routine. The special macro definition 
writes the TESTEXIT data set defined by the DD card having the DDNAME of 
MANX. (With the normal SMFWTM macro instruction, the data is written to 
SYS1.MANX or SYS1.MANY.) You can then process the data without accessing the 
system accounting data on SYS1.MANX and SYS1.MANY. When testing is 
completed the macro definition must be removed. 


Figure 38 shows the SMFWTM macro instruction that is required for testing. 


ENAME 


.E1 
. BAL 


ENAME 
sbISt 


. REGA 
ENAME 


. LODIT 


ENAME 


MACRO 


SMFWTM 


AIF 
AIF 
AIF 
AGO 
MNOTE 
MEXIT 
ANOP 
CNOP 
BAL 
DC 


L 
BALR 
MEXIT 
ANOP 
LR 
CNOP 
BAL 
AGO 
ANOP 
LA 
CNOP 
BAL 
AGO 
MEND 


&EMSGAD 

('EMSGAD' EQ '').E1 
('&MSGAD' EQ '(1)').BAL 
('&MSGAD'(1,1) EQ '(').REGA 
.LODIT 


'*** NO OPERAND SPECIFIED ***' 


0,4 

15, *+8 

V( TSMFWTM ) 
15,0(15) 
14,15 


1, &MSGAD( 1 ) 
0,4 

15,*+8 
ple EL 


Figure 38. SMFWTM Macro Definition Required for Testing 
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TESTEXIT Procedure 


Included in the test procedure is an Assembler language source program (also named 
TESTEXIT). This source program attaches the data generator utility program 
(IEBDG) to create sample parameter lists; TESTEXIT then calls each exit routine 
being tested, passing the appropriate parameter list to it. Figure 39 illustrates the 
input/output and control flow of the TESTEXIT routine. 
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Figure 39. TESTEXIT Input/Output and Control Flow 
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Figure 40 is an example of JCL that invokes TESTEXIT in an unmodified system. 
Following is a summary of the operations performed by the procedure shown in 
Figure 40 : 


e The TESTEXIT job assembles the TESTEXIT routine (not illustrated in the figure) J 
and link-edits it with the exit routines being tested. The exit routines must reside in 
a partitioned data set (EXITLIB). 


e The DATAGEN job, using the IEBUPDTE utility program, creates a partitioned data 
set (DGINPUT) containing control statements for the IEBDG utility program, which 
will be attached by the TESTEXIT program. : 


e The TESTING job includes the execution of the TESTEXIT program. 


The 1 at the right side of the figure indicates exits available only when VS1 is used; 
the 2 at the right side of the figure indicates exits available only when VS2 is used. 


//TESTEXIT JOB MSGLEVEL=1 

//TEST EXEC. ASMFCL 

//BRSM.SYSIN DD * 

(TESTEXIT Source Module) 

ve * 

//LKED.SYSLMOD DD DSNAME=TESTLIB, VOLUME=SER=231400, 

f UNIT=2314,SPACE=(TRK,(5,2,1)), 
DISP=( NEW, KEEP ) 

//LKED.EXITS DD DSNAME=EXITLIB, VOLUME=SER=231400, 
UNIT=2314,DISP=OLD 

//LKED.SYSIN DD * 

INCLUDE EXITS( ITEFUJV, IEFUJI,IEFUSI,IEFUTL,I EFACTRT,IEFUJP, C 
IEFUIV, IEFUSO C 1 
ITEFUB83 ) 

ENTRY TESTEXIT 

NAME TESTEXIT 


/* 

/ / DATAGEN JOB MSGLEVEL=1 ) 
EXEC PGM=IEBUPDTE, PARM=NEW — 

//SYSUT2 DD DSNAME=DGINPUT, UNIT=2314,DISP=(, 
VOLUME=SER=231400 ,SPACE=( TRK,(10,5,1) 
DCB=( LRECL=80, BLKSIZE=400 , RECFM=EFB ) 

//SYSPRINT DD SYSOUT=A 

//SYSIN DD SYSOUT=A 

./ ADD NAME=UIV 1 


(IEBDG Control Statements for IEFUIV) 

./ ADD NAME=UJV 

(IEBDG Control Statements for IEFUJV) 

./ ADD NAME=UJI 

(IEBDG Control Statements for IEFUJI) 

./ ADD NAME=USI 

(IEBDG Control Statements for IEFUSI) 

-/ ADD NAME=USO 1 
(IEBDG Control Statements for IEFUSO) 

./ ADD NAME=UTL 

(IEBDG Control Statements for IEFUTL) 

./ ADD NAME=U83 2 
(IEBDG Control Statements for IEFU83) 

./ ADD NAME=ACT e 
(IEBDG Control Statements for IEFACTRT) 


Figure 40. TESTEXIT Procedure JCL (Part 1 of 2) 


KEEP ), 
) 
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./ ADD 


NAME=UJUP 


(IEBDG Control Statements for IEFUJP) 


./ ENDUP 
/* 
//TESTING 
//JOBLIB 


JOB MSGLEVEL=1 

DD DSNAME=TESTLIB, VOLUME=SER=231400, 
UNIT=2314,DISP=( OLD, KEEP ) 

EXEC PGM=TESTEXIT, 


// PARM='UIV=2,UJV=26,UJ1=10,USI=5, USO=2, UTL=5 ,U83=3,ACT=2,UJP=2' 


//INUIV 
// 
//INUIV 
// 
//INUII 
ii, 
// 
//INUSI 
// 
LT, 
//INUSO 
// 
// 
//INUTL 
// 
// 
//INU83 
/ 7 
77, 
//INACT 
//TNUIP 


we 


dd. 
//OUTULV 
L7, 


7i- 
//OUTUIV 
77. 
Ti 
//OUTUSI 
77 
if, 
/ /OUTUSI 
i. 
Vas 
/ /OUTUSO 
77 
iy, 
//OUTUTL 
Ff 
77 
/ /OUTU83 


//OUTACT 
if 


/ /OUTUIP 
// 

Td 

J /MANX 

7d. 

ey 
//SYSPRINT 


//DGPRINT 
//SYSABEND 
* 


DD DSNAME=DGINPUT( UIV),DCB=( LRECL=80, 
BLKSIZE=400,RECFM=FB ),DISP=(OLD,PASS), 
UNIT=2314, VOLUME=SER=231400 

DD DSNAME=DGINPUT( UJV ),DCB=( LRECL=80, 
BLKSIZE=400,RECFM=FB ),DISP=(OLD,PASS), 
UNIT=2314, VOLUME=SER=231400 

DD DSNAME=DGINPUT( UJI ), DCB=( LRECL=80, 
BLKSIZE=400,RECFM=FB ),DISP=(OLD,PASS), 

UNI T=2314, VOLUME=SER=231400 

DD DSNAME=DGINPUT( USI ),DCB=( LRECL=80, 
BLKSIZE=400,RECFM=FB ),DISP=(OLD,PASS), 
UNIT=2314, VOLUME=SER=231400 

DD DSNAME=DGINPUT( USO), DCB=( LRECL=80, 
BLKSIZE=400,RECFM=FB ),DISP=(OLD,PASS), 
UNIT=2314, VOLUME=SER=231400 

DD DSNAME=DGINPUT( UTL),DCB=( LRECL=80, 
BLKSIZE=400,RECFM=FB ),DISP=(OLD,PASS), 
UNIT=2314, VOLUME=SER=231400 

DD DSNAME=DGINPUT( U83 ), DCB=( LRECL=80, 
BLKSIZE=400,RECFM=FB ),DISP=(OLD,PASS), 
UNIT=2314,VOLUME=SER=231400 

DD DSNAME=DGINPUT( ACT ),DCB=( LRECL=80, 
BLKSIZE=400,RECFM=FB ),DISP=(OLD,PASS), 
UNIT=2314, VOLUME=SER=23 1400 

DD DSNAME=DGINPUT( UJP ), DCB=( LRECL=80, 
BLKSIZE=400,RECFM=FB ),DISP=(OLD,PASS), 

UNI T=2314,VOLUME=SER=23 1400 

DD DSNAME=UIV( OUT), UNIT=2314,DISP=(,PASS), 
SPACE=(TRK,(10,5,1)),VOLUME=SER=231400, 
DCB=( LRECL=80 , BLKSIZE=400 , RECFM=EB ) 

DD DSNAME=UJV( OUT), UNIT=2314,DISP=(,PASS), 
SPACE=( TRK,(10,5,1)),VOLUME=SER=231400, 
DCB=( LRECL=80, BLKSIZE=400, RECFM=EFB ) 

DD DSNAME=UJI1( OUT), UNIT=2314,DISP=(,PASS), 
SPACE=(TRK,(10,5,1)),VOLUME=SER=231400, 
DCB=( LRECL=80 , BLKSIZE=400 , RECFM=EFB ) 

DD DSNAME=USI( OUT ),UNIT=2314,DISP=(,PASS), 
SPACE=( TRK,(10,5,1)),VOLUME=SER=231400, 
DCB=( LRECL=80 , BLKSIZE=400 , RECFM=EB ) 

DD DSNAME=USO( OUT), UNIT=2314,DISP=(,PASS), 
SPACE=(TRK,(10,5,1)),VOLUME=SER=231400, 
DCB=( LRECL=80 , BLKSIZE=400 , RECFM=EFB ) 

DD DSNAME=UTL( OUT), UNIT=2314,DISP=(,PASS), 
SPACE=( TRK,(10,5,1)),VOLUME=SER=231400, 
DCB=( LRECL=80 , BLKSIZE=400 , RECFM=EFB ) 

DD DSNAME=U83( OUT), UNIT=2314,DISP=(,PASS), 
SPACE=(TRK,(10,5,1)),VOLUME=SER=231400, 
DCB=( LRECL=130,BLKSIZE=130,RECFM=FB ) 

DD DSNAME=ACT( OUT), UNIT=2314,DISP=(,PASS), 
SPACE=( TRK,(10,5,1)),VOLUME=SER=231400, 
DCB=( LRECL=130,BLKSIZE=130,RECFM=FB ) 

DD DSNAME=UJP( OUT ), UNIT=2314,DISP=(,PASS), 
SPACE=( TRK,(10,5,1)),VOLUME=SER=231400, 
DCB=( LRECL=130, BLKSIZE=130,RECFM=EFB ) 

DD UNIT=2314,VOLUME=SER=231400,DSN=MANX, 
SPACE=(TRK,(3,1)),DISP=(NEW,KEEP), 

DCB=( BLKSIZE=200, LRECL=196 ) 

DD SYSOUT=A , DCB=( BLKSIZE=136, LRECL=132 ) 
DD SYSOUT=A 

DD SYSOUT=A 


Figure 40. TESTEXIT Procedure JCL (Part 2 of 2) 
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Using TESTEXIT 


To use the TESTEXIT procedure you must do the following: 

e Place your exit routines in a partitioned data set. 

e Obtain a punched deck of TESTEXIT from SYS1.ASAMPLIB. 
« Modify the procedure to meet your testing requirements. 

e Execute the three jobs in the procedure. 

e Print the MANX data set if it has data. 


The procedure provided in SYS1.ASAMPLIB, without modification, can be used to 
link-edit the sample exit routines (also in SYS1.ASAMPLIB), generate sample 
parameter lists, and test the sample exit routines. You should consider linkage-editor 
and data-generator modifications in adapting the procedure to your testing 
requirements. These modifications are discussed in the topics that follow. 


Linkage Editor Modifications 


The linkage editor step of the first job (TESTEXIT), shown in Figure 40, link-edits 
the TESTEXIT program with the exit routines. You must substitute an INCLUDE 
control statement specifying the names of the exit routines you are testing. 


Data Generator Modifications 


The second job (DATAGEN), shown in Figure 40, creates a partitioned data set 
containing control statements for the IEBDG utility program. The control statements 
supplied with the procedure will generate samples of standard parameter lists. You 
should omit control statements and their associated ADD statements for any exit 
routines you are not testing. If you are testing for special conditions or require 
additional test parameters, you must make appropriate modifications and additions 
to the control statements. 


Figure 41 shows the JCL that can be used to place user written routines into 
EXITLIB, a partitioned data set. The 1 at the right side of the figure indicates exits 
available only when VS1 is used; the 2 at the right side of the figure indicates exits 
available only when VSz2 is used. 


Figure 42 shows the JCL that can be used to obtain a punched deck of TESTEXIT. 


Note that you must provide control statements in such an order that the records 
subsequently generated by the IEBDG utility will be grouped as complete parameter 
lists that conform in length and format to the exit parameters previously defined in 
this chapter. (The entry code passed to exits IEFACTRT and IEFUTL in register 0 
must be included as a one-byte parameter at the end of the parameter lists for those 
exits.) For detailed information on the use of IEBDG control statements, refer to 
OS/VS Utilities, GC35-0005. 
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//UPDTE JOB MSGLEVEL=1 
// EXEC PGM=IEBUPDTE, PARM=NEW 


//SYSUT2 DD DSNAME=EXITLIB, VOLUME=SER=231400, 
// UNIT=2314,SPACE=( TRK,(10,3,1)), 

// DCB=( LRECL=80, BLKSIZE=400 , RECFM=FB ) 
//SYSPRINT DD SYSOUT=A 

//SYSIN DD DATA 

./ ADD NAME=IEFUIV 1 
(IEFUIV object deck) 

./ ADD NAME=IEFUJV 

(IEFUJV object deck) 

./ ADD NAME=IEFUJ 1 

(IEFUJI object deck) 

./ ADD NAME=IEFUSI 

(IEFUSI object deck) 

./ ADD NAME=IEFUSO 1 
(IEFUSO object deck) 

./ ADD NAME=IEFUTL 

(IEFUTL object deck) 

./ ADD NAME=IEFU83 2 
(IEFU83 object deck) 

./ ADD NAME=IEFACTRT 

(IEFACTRT object deck) 

./ ADD NAME=IEFUJP 

(IEFUJP object deck) 

./ ENDUP 

/* 


Figure 41. JCL for Entering Exit Routines into EXITLIB 


EXEC PGM=IEBPTPCH 

//SYSPRINT DD SYSOUT=A 
//SYSUT1 DD DSNAME=SYS1.ASAMPLIB,DISP=(OLD,KEEP), 
// UNI T=XXXX , VOLUME=SER=XXXXXX! 
//SYSUT2 DD UNIT=2540-2 
//SYSIN DD * 

PUNCH TY PORG=PO , MAXNAME=1 , MAXFLDS=1 

MEMBER NAME=TESTEXIT 

RECORD FIELD=( 80) 


//PUNCH JOB  MSGLEVEL=1 
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/* 


1 The volume and unit parameters depend on your installation’s request; check with your system 
programmer. 


Figure 42. JCL for Obtaining a Punched Deck of TESTEXIT 


Exit Routines 1M 


TESTEXIT Execution Modifications 
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The third job (TESTING), shown earlier in Figure 40, includes execution of the 
TESTEXIT program. Values for the PARM parameter of the EXEC statement specify 
which exit routines are to be tested and the number of times each is to be tested. 
This parameter has the format PARM=‘xxx=nnn,...,xxx=nnn’ where nnn is the 
number of times an exit routine is to be tested (the maximum value is 255), and xxx 
is an exit routine identifier. The DD statements to be included depend upon the exit 
routines to be tested. 


Figure 43 shows the exit-routine identifiers, specified on the EXEC statement, and 
the DD statements that must be included for each exit routine to be tested. DD 
statements for any other data sets used by your exit routines must be included in the 
TESTEXIT JCL. 


Exit Routine | Identifier | DD Statements 


IEFUN 
IEFUSI__| _USI 




































IEFUSO USO 


Any MANX, SYSPRINT, DGPRINT, SYSABEND 


Figure 43. Parameters and DD Statements for Executing TESTEXIT 
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Accounting Records 


Accounting records describe for each job and job step the user of the system, the 
resources used, and the completion status of the job or job step. The following 


record types, which constitute the group of accounting records, are described in 
this chapter: 


e Record type 4—Step Termination. 

e Record type 5—Job Termination. 

e Record type 6—Output Writer. 

¢« Record type 26—Job Purge (only VS2 with HASP). 
e Record type 34—TS-Step Termination (VS2 only). 
e Record type 35—Logoff (VS2 only). 

e Record type 40—Dynamic DD (VS2 only). 


Fields in these records marked ‘“‘Reserved’’ are reserved for use by SMF and are 
not available for your use. 
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Record Type 4 


Record Type 4—Step Termination 


Record type 4 is written at the normal or abnormal termination of a job step or 
when a job step is flushed during or after job initiation. The length is 117 bytes 
plus (1) 8 bytes for each device entry and (2) the length of the step accounting 
fields. 


The job step is identified by job log number (job name and time and date that the 
reader recognized the JOB card for the job), step name, the number of the job 
step within the job, the user identification field (which may be initialized by the 
installation to facilitate subsequent sorting of records), and the program name. If 
accounting numbers (which can be alphameric) were specified in the EXEC 
statement, they are included. 


The record provides operating information such as the time the job step was 
started and completed, the CPU time, the amount of storage allocated and used, 
and the termination status, the number of records in DD DATA and DD * data sets 
for the step, the time that device allocation started, the time that the problem 
program was loaded, and the storage protect key. In VS1, input/output activity is 
recorded for each non-spooled data set for which the user has a DD statement; in 
VS2, it is recorded for all data sets for which the user has a DD statement. Each 
entry lists the EXCP count for the data set and lists the device class, type, and 
address. 


Data sets are recorded in the order of the step DD statements; they are not 
identified by name. A user written exit routine can record this order as each 
statement is validated if a report on data set activity is needed. 


The EXCP count appears in SMF record types 4, 14, and 15. It indicates the 
input/output activity required by the job. The EXCP count includes direct EXCPs, 
program controlled interruptions (PCIs), and channel-end and abnormal-end EXCP 
returns. When chained scheduling is used, the EXCP count may vary from run to 
run for the same job. These system functions are designed to optimize 
input/output activity, and, therefore, the number of EXCPs required will depend on 
system and program interaction at the time the input/output is performed. The 
variation due to chained scheduling will be reflected in the counts for any data set 
using chained scheduling. 


The format is: 


Decimal Hexadecimal Field Data 


Displacement Displacement Size Format Contents 
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0 0 | binary System indicator 
Bit Meaning When Set 
6 VS2 
7 VS1 
| 1 | binary Record type 
Z 2 4 binary Time, in hundredths of a second, of end of 
step 
6 6 4 packed Date of end of step, in the form 00YYDDDF, 
where F is the sign 
10 A 2 EBCDIC System identification 
12 C 2 EBCDIC System model identifier 
14 E 8 EBCDIC Job name! 
22 16 4 binary Time, in hundredths of a second, that the 
reader recognized the JoB card for this job! 
26 1A 4 packed Date that the reader recognized the JOB card 
for this job! 
30 1E 8 EBCDIC User identification field from common exit 
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parameter area 


Decimal Hexadecimal Field 

Displacement Displacement Size 
38 26 l 
39 2] 4 
43 2B 4 
47 2F 4 
51 33 2 
53 35 | 
54 36 8 
62 3E 8 
70 46 2 
72 48 Z 
74 4A 2 
76 4C 6 
82 52 1 
83 53 1 
84 54 2 
86 56 4 
90 SA 4 
94 SC 4 
98 62 2 
100 64 2 
102 66 2 


For each device, there is an eight-byte 
1 


1 


Data 
Format 


binary 
binary 


packed 
binary 


binary 
binary 


EBCDIC 
EBCDIC 
binary 
binary 
binary 
binary 
binary 


binary 


binary 
binary 


binary 


binary 
binary 


binary 


binary 


Contents 


Step number (first step=1, etc.) 


Step initiation time, in hundredths of a 
second, which is the time of day when this 
step was selected by the initiator 


Step initiation date 


Number of card-image records in DD DATA 
and DD * data sets read by the reader for the 
job step 


Step completion code? 


Step priority (See OS/VS Supervisor 
Services and Macro Instructions, GC27-6979) 


Program name 

Step name 

Partition or region size, in 1K blocks? 
Reserved 

Storage used3 

Reserved 


Storage protect key (xxxx0000, where xxxx is 
the key which is described under TCBPKF in 
OS/VSI System Data Areas, SY28-0605, and 
OS/VS2 System Data Areas, SY28-0606) 


Step termination indicators 


Bit Meaning When Set 

0 Reserved 

1 vsi—Canceled by IEFUJV‘4 
VS2—Reserved 

2 Canceled by IEFUJI4* 

3 Canceled by IEFUSI4 

4 Canceled by IEFACTRT‘* 

5 Reserved 

6 0—Normal completion 
1—ABEND? 

7 Step not executed (that is, step was 
flushed) 

Reserved 


Device allocation start time of day, in 
hundredths of a second 


Problem program load time of day, in 
hundredths of a second 


Reserved 
Record indicators 
Bit Meaning When Set 


7 0—Storage is virtual 

1—Storage is real 
Offset from beginning of the record header 
to the relocate section 
Length of device entry portion, including 
this field, which is calculated: (8 x d) + 2, 
where d=number of devices ® 


entry with the following format: 


binary 
binary 


binary 
binary 


Device class from UCBTY?P field of unit 
control block 


Unit type from UCBTYP field of unit control 
block 


Channel/unit address 
EXCP count 
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Decimal Hexadecimal Field Data 
Displacement Displacement Size Format Contents 


After the device entries are the following fields: 
Accounting Section: 


1 binary Total length of next three fields: step CPU 
time, number of accounting fields, and the 
accounting fields 


3 _—scObinary Step CPU time, in hundredths of a second? 
1 binary Number of accounting fields 
EXEC statement accounting fields 


Relocate Section: 


+09 4 binary Number of page-ins for this job step 
+4 4 binary Number of page-outs for this job step 


! The job name and the time and date that the reader recognized the JOB card for this job 
constitute the job log number. 


2 The contents of the completion code field vary according to the condition of termination, as 
follows: 


X‘Occc’, which indicates system ABEND in the job step; ccc is the system ABEND code (see 
OS/VS Message Library: VSI System Codes, GC38-1003 or OS/VS Message 
Library: VS2 System Codes, GC38-1008). 

X‘8ccc’, which indicates user ABEND in the job step; ccc is the user ABEND code. 

X‘nnnn’, which indicates normal completion; nnnn is the contents of the two low-order 
bytes in register 15 at termination. 

X‘0000’, which indicates either (1) that the job step was not executed—that is, it was 
flushed— because of an error, during allocation or in a preceding job step or (2) a 
return code of 0, indicating normal job completion. To distinguish between a job 
step flush code and a normal termination code and to distinguish between a system 
ABEND and a user ABEND, see the step termination indicators field. 


3 If the job step is run with ADDRSPC=REAL, then the partition-size and storage-used fields are 
the same and are equal to the amount of real storage requested. 


4 Job steps canceled by IEFUJV (VS1), IEFUJI, or IEFUSI will not be executed; therefore bit 7 
will also be turned on. Job steps canceled by IEFACTRT will cause subsequent job steps to be 
canceled; bit 7 will be turned on for subsequent steps. 


5 If this bit indicates an ABEND, check the completion code field to determine the cause of the 
ABEND. A completion code of 0322 or 0522 indicates that the ABEND was caused by IEFUTL. 
A completion code of 0722 indicates that the ABEND was caused by IEFUSO. 


6 There is an entry for each device assigned to each non-spooled data set in vS1 and for each 
device assigned to each data set in VS2. For DD *, DD DATA, and SYSOUT data sets, there is 
no entry. For a DD DUMMY data set the entry is set to 0. (A DD DUMMY entry results when 
a forward reference to a DD name is encountered in the input stream but a DD statement 
having that DD name is not found or when DD DUMMY is specified.) 


7 CPU time is not expected to be constant between different runs of the same step. One or 
more of the following factors may cause small variations in CPU time: channel program 
retries, CPU architecture (such as core buffering), cycle stealing with integrated channels, 
queue searching, (such as task switching), and pending interruptions. 


8 Each entry for an accounting field contains the length of the field (one byte, binary), 
followed by the field (EBCDIC). An omitted field is represented by a length indicator of 0. 


9 The displacement of this field is variable depending on the number of accounting fields. 
The value contained in the field at displacement 100 is the displacement of this field. 
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Record Type 5 


Record Type 5—Job Termination 


Record type 5 is written at the normal or abnormal termination of a job or when a 
job step is flushed during or after job initiation. The length is 117 bytes plus the 
length of the job accounting fields. The maximum length of this record type is 261 


bytes. 


The job is identified by job log number, programmer name, the 
installation-supplied user identification field, input class, requested priority, and the 
accounting fields from the JOB statement. Operating information includes the start 
and stop time for processing of the job by the reader and the device type and 
class of the reader device. (The device type and class of reader device is not 
provided for foreground-initiated background jobs.) The number of records in DD 
DATA and DD * data sets for the job and the number of steps in the job are 
included. Job CPU time equals the sum of the job step CPU times. The job 
completion code is recorded, along with the storage protect key and a termination 
code indicating which of four SMF user written exit routines, if any, canceled the 
job. A flag marks each SYSOUT class used by the job. 


The format is: 


Decimal 


0 


12 
14 
22 


26 
30 
38 


39 


43 
47 


51 
53 
54 


38 


Hexadecimal 
Displacement Displacement Size 


0 


amar> a w 


1E 
26 
27 


2B 
2F 


33 
35 
36 


3A 


1 


Field Data 


Format 


binary 


binary 
binary 


packed 


EBCDIC 
EBCDIC 
EBCDIC 
binary 


packed 
EBCDIC 
binary 


binary 


packed 
binary 


binary 
binary 
binary 


packed 


Contents 


System indicator 
Bit Meaning When Set 


6 VS82 
7 VS1 


Record type 

Time, in hundredths of a second, of end of 
job 

Date of end of job, in the form 00YYDDDF, 
where F is the sign 

System identification 

System model identifier 

Job name! 


Time, in hundredths of a second, that the 
reader recognized the JOB card for this job! 


Date that the reader recognized the JOB card 
for this job! 


User identification field from common exit 
parameter area 


Number of steps in the job 


Job initiation time, in hundredths of a 
second, which is the time of day the job was 
selected by the initiator 


Job initiation date 


Number of card-image records in in DD 
DATA and DD * data sets for the job read by 
the reader 


Job completion code? 

Job priority 

Time, in hundredths of a second, that the 
reader recognized the end of the job 


Date that the reader recognized the end of 
the job 
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Decimal 


62 


63 
68 
69 
70 
71 
72 


73 
76 


83 
92 


93 
113 
116 
117 


Hexadecimal 
Displacement Displacement Size 


3E 


3F 


45 
46 
47 
48 


49 
4C 


53 
5C 


5D 
71 
74 
75 


Field Data 

Format 

1 binary 

5 binary 

1 binary 

1 binary 

1 binary 
1 EBCDIC 

1 binary 

3 binary 
7 EBCDIC 

9 binary 

1 binary 
20 EBCDIC 

3 binary 

1 binary 


Contents 


Job termination indicator 
Bit Meaning When Set 
Reserved 


1 vsi—Canceled by exit IEFUJV 
vS2—Reserved 


2 Canceled by exit IEFUJI 

3 Canceled by exit IEFUSI 

4 Canceled by exit IEFACTRT (step exit 
only) 

5 Reserved 

6 Q—Normal completion 
1—A step within the job abnormally 
ended 

7 Reserved 

SYSOUT class indicator‘ 

Reserved 


Reader device class from UCB 
Reader unit type from UCB 
Job input class 


Storage protect key (xxxx0000, where xxxx is 
the key which is described under TCBPKF in 
OS/VSI System Data Areas, SY28-0605, 
and OS/VS2 System Data Areas, 
SY28-0606) 


Reserved 


vsi—User’s logon identifier. 

Non-terminal oriented jobs have an 
identifier of ‘CENTRAL’; terminal oriented 
jobs have as the identifier the QIDLGNID 
field from the Job Management Record for 
the terminal through which the job was 
submitted. 

VS2—Reserved 

Reserved 


Length of rest of record not including this 
field 


Programmer's name 
CPU time used by the job5 
Number of accounting fields following 


JOB statement accounting fields (variable 
length)® 


1 The job name and the time and date that the reader recognized the JoB card for this job 


constitute the job log number. 


2 The contents of the completion code field vary according to the condition of termination of 
steps processed by the scheduler, as follows: 


which indicates system ABEND in the last job step that abnormally terminated; ccc 
is the system ABEND code (see OS/VS Message Library: VS1 System Codes, 
GC38-1003 or OS/VS Message Library: VS2 System Codes, GC38-1008). 

which indicates user ABEND in the last job step that abnormally terminated; ccc is 
the user ABEND code. 
which indicates normal completion; nnnn is the contents of the two low-order 
bytes in register 15 at termination. 
which indicates a return code indicating normal job completion. 


X‘Occc’, 


X‘8ccc’, 
X‘nnnn’, 


X*0000’, 


Job termination indicators are provided at byte 62 of this record. For more detailed 
information on job step termination, examine record type 4. 


3 The job priority is normally the user-assigned priority (0-13). If the job fails while being 
scheduled (for example, during device allocation), this field shows a priority of 14, reflecting 
ABEND processing. 
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Each bit of the indicator represents the following classes: 


Byte 0 Byte | Byte 2 Byte 3 Byte 4 
Bit-Class Bit-Class Bit-Class Bit-Class Bit—Class 


0-A 0-I 0-Q 0-Y 0-6 
1-B 1-J 1-R 1-Z 1-7 
2-C 2-K 2-S 2-0 2-8 
3-D 3-L 3-T 3-1] 3-9 
4-E 4-M 4-U 4-2 
5—F 5—-N 5-V 5-3 
6—-G 6—O 6—W 6—4 
7-H 7-P 7-X 7-5 


Usually, this is the class specified by the SYSOUT parameter on the DD statement: 


The CPU time is the time used for the problem program by the CPU between job initiation 
and job termination. This time also includes the time spent in interrupt processing for other 
programs when this problem program is the interrupted task. 

CPU time is not expected to be constant between different runs of the same job. One or more 
of the following factors may cause small variations in CPU time: channel program retries, CPU 
architecture (such as core buffering), cycle stealing with integrated channels, queue searching, 
(such as task switching), and pending interruptions. 

Each entry for an accounting field contains the length of the field (one byte, binary), followed 
by the field (EBCDIC). An omitted field is represented by a length indicator of 0. 
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Record Type 6 


Record Type 6—Output Writer 


Record type 6 is written when the writer has finished processing a SYSOUT class 
or form within a class for a job. At least one output writer record is written for 
each SYSOUT class used by the job. If two or more forms are used within a class, 
one output writer record is produced for each form. The length is 57 bytes in a 
VS2 system without HASP, 64 bytes in a VS1 system, and 90 bytes in a VS2 system 
with HASP. In all cases, the first 57 bytes are the same. 


The output writer is identified by class and form number. The job is identified by 
job log number and the installation user identification. Output writer activity is 
recorded by a count of the number of logical records processed, the number of 
SYSOUT data sets within the class and form, writer start and end times, and a code 
indicating any input/output errors. 


If the standard writer is replaced by a user-supplied writer, SMF does not produce 
a complete record type 6. An incomplete record type 6 is written for each output 
class (but not for form changes within an output class) if the writing of records is 
allowed. In this case, the number of logical records, I/O status indicators, and form 
number fields are not provided. 


The format is: 
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Decimal Hexadecimal Field Data 
Displacement Displacement Size Format Contents 
0 0 I binary System indicator 
Bit Meaning When Set 
6 VS82 
7 VS1 
l 1 1 binary Record type 
2 2 4 binary Time, in hundredths of a second, record was 
moved to SMF buffer 
6 6 4 packed Date record was moved to SMF buffer, in 
the form 00YYDDDF, where F is the sign 
10 A 2 EBCDIC System identification 
12 C 2 EBCDIC System model identifier 
14 E 8 EBCDIC Job name! 
22 16 4 binary Time, in hundredths of a second, that the 
reader recognized the JOB card for this job! 
26 1A 4 packed Date that the reader recognized the JOB card 
for this job! 
30 1E 8 EBCDIC User identification field from common exit 
parameter area 
38 26 1 EBCDIC SYSOUT class 
39 27 4 binary Time of SYSOUT start 
43 2B 4 packed Date of SYSOUT start 
47 2F 4 binary Number of records written by the writer, by 
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form number and by class 


Decimal 


51 


52 


53 


Hexadecimal 
Displacement Displacement Size 


33 


34 


35 





Field Data 


1 


4 


Format 


binary 


binary 


EBCDIC 


The following field applies when VSI is used: 


oy 


39 


7 


EBCDIC 


Contents 


1/O status indicator in VS1 and VS2 without 
HASP 


Bit Meaning When Set 
0-3 Reserved 


4 1/O discontinued (remote output only) 
5 Input error 

6 Output error 

7 Input error on SYS1.SYSJOBQE 


I/O status indicator in VS2 with HASP 
Bit Meaning When Set 
0-4 Reserved 


5 Data input error 
6 Reserved 
7 Control block input error 


Total number of data sets processed by 
writer for this job. In a VS2 system with 
HASP, the total number of data sets 
processed for this class and form. If multiple 
copies are produced, each copy is counted. 


Form number 


User's logon identifier. 

Non-terminal oriented jobs have an 
identifier of ‘CENTRAL’; terminal oriented 
jobs have as the identifier the QIDLGNID 
field from the Job Management Record for 
the terminal to which the output was routed. 


The following fields only apply to VS2 with HASP: 


57 
64 
68 
76 
80 
84 
88 


39 
40 
44 
4C 
50 
54 
58 


& bk OO LN 


2 


binary 
EBCDIC 
EBCDIC 
EBCDIC 
EBCDIC 
binary 
binary 


Reserved in VS2 

HASP assigned job number 
HASP logical output device name 
FCB identifier 

UCS identifier 

Page count? 

Output route code 


1 The job name and the time and date that the reader recognized the JOB card for this job 


constitute the job log number. 


2 These fields apply only to printed output. 
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Record Type 26 


Record Type 26—Job Purge 


Record type 26 (VS2 with HASP only) is written at the normal or abnormal J 
| termination of a job. The length is 46 bytes, plus the length of the descriptor, 
events, and actuals sections. The minimum length is 224 bytes. 


The job is identified by job log number, programmer name, and HASP job number. 

Operating information includes the start and stop time for processing of the job by q 
the reader, execution and SYSOUT output phases, HASP logical input device name, 

and output statistics. 


The format is: 4 


Decimal Hexadecimal Field Data 
Displacement Displacement Size Format Contents 


0 0 | binary System indicator 
Bit Meaning When Set 
6 VS2 

l l 1 binary Record type 

2 2 4 binary Time, in hundredths of a second, record was 
moved to SMF buffer 

6 6 4 packed Date record was moved to SMF buffer in the 


form 00YYDDDF, where F is the sign 





10 A Z EBCDIC System identification 

12 C 2 EBCDIC System model identifier 

14 E 8 EBCDIC Job name 

oe 16 4 binary Time, in hundredths of a second, that the 
reader recognized the JOB card for this job 

26 1A 4 packed Date that the reader recognized the job card 
for this job 

30 1E 8 EBCDIC User identification field from common exit 
parameter area 

38 26 4 binary Reserved 

42 2A Z binary Subsystem identification—X‘0002’ signifies 
HASP 

44 2C 2 binary Section indicator 


Bit Meaning When Set 


0 Descriptor section present 
| Events section present 

2 Actuals section present 
3-15 Reserved 


Descriptor Section: 


+0 2 binary Length of descriptor section, including this 
field 

+2 3 binary Reserved 

+5 1 bifiary Job information 


Bit Meaning When Set 


0 /*PRIORITY card present! 

1 /*SETUP card present 

2 TYPERUN=HOLD 

3 No job log option a 
4 Execution batching 

5-6 Reserved 

7 Job canceled by the operator 


+6 4  EBCDIC  HASP assigned job number be 
+10 8 EBCDIC Reserved 
+18 20 EBCDIC Programmer's name 
+38 1 EBCDIC Message class from job card 
+39 | EBCDIC Job class ftom job card 
+40 2 binary HASP execution selection priority? 
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~ @, 


Decimal Hexadecimal 


Displacement Displacement Size 


Descriptor Section: 
+42 
+44 
+46 
+54 
+58 
+62 
+66 
+70 
+74 
+78 
+80 
+82 
+84 


Events Section: 
+0 
+2 
+4 
+8 

+12 
+28 
+32 
+36 
+40 
+44 
+48 
+52 
+56 


Actuals Section: 
+0 
+2 


+4 


+8 
+12 
+16 
+20 
+24 
+28 


1 Unless /*PRIORITY is *. 


Field Data 


NNN WN Ff FF FL FH HH HL TON NN 


kh RN N 


— 
fo. 


& £ fH Hf £ FH HK A 


kk N N 


fF ff Hh SH 


Format 


binary 
binary 
EBCDIC 
EBCDIC 
EBCDIC 
binary 
binary 
binary 
EBCDIC 
binary 
binary 
binary 
binary 


binary 
binary 
binary 
packed 
binary 
binary 
packed 
binary 
packed 
binary 
packed 
binary 
packed 


binary 
binary 


binary 


binary 
binary 
binary 
binary 
binary 
binary 


Contents 


HASP output selection priority2 
Input route code 

HASP logical input device name 
Programmer's accounting number? 
Programmers room number? 
Estimated execution time3 
Estimated output lines3 

Estimated output punched 

Output form number3 

Print copy count (if for all of job)3 
Lines per page? 

Print route code 

Punch route code 


Length of events section, including this field 
Reserved 

Reader stop time 

Reader stop date 

Reserved 

Execution start time 
Execution start date 
Execution stop time 
Execution stop date 
Output processor start time 
Output processor start date 
Output processor stop time 
Output processor stop date 


Length of actuals section, including this field 
Reserved 

Number of input cards for job (JCL and 
SYSIN cards) a 

Output lines generated to spool 

Output punched cards generated to spool 
Reserved 

Lines printed by subsystem 

Pages printed by subsystem 

Cards punched by subsystem 


2 The four high order bits of the second byte contain a priority number (1-15). 
3 These fields are HASP defined subfields from the accounting information field in the JOB card 


or default values assigned for this job. 
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Record Type 34 


Record Type 34—TS-Step Termination 


Record type 34 (vS2 only) is written each time the TSO logoff function processes 
a job step termination. The length is 129 bytes plus (1) 8 bytes for each device 
entry and (2) the length of the step accounting fields. 


This record contains the record type, time stamp (time and date), CPU 
identification, LOGON time, main storage occupancy time, count of TGETs satisfied 
and TPUTs issued, the time device allocation started, the time the problem program 
was loaded, job step CPU time, termination status, TMP name, job step name, size 
of region, and main storage used and the storage protect key. Input/output activity 
is recorded for each data set used by this job step; each entry lists the device 
class, type, and address, and the EXCP count for the data set. The data-set entry is 
zeros when the DD entry is TERM, DUMMY, or DYNAM. 


The format is: 


Decimal Hexadecimal Field Data 
Displacement Displacement Size Format Contents 


0 0 1 binary System indicator 
Bit Meaning When Set 
6 VS2 
1 1 1 binary Record type 
2 2 4 binary Time, in hundredths of a second, that step 
terminated 
6 6 4 packed Date that step terminated, in the form 
OOYYDDDF, where F is the sign 
10 A 2 EBCDIC System identification 
12 C 2 EBCDIC System model identifier 
14 E 8 EBCDIC User identification field 
22 16 4 binary LOGON time of day in hundredths of a 
second 
26 1A 4 packed LOGON date, in the form 00YYDDDF, where 
F is the sign. 
30 1E 8 EBCDIC _ Reserved for user (blanks) 
38 26 1 binary Step sequence number 
39 27 4 binary Main storage occupancy time, in hundredths 
of a second! 
43 2B 4 binary Line-out count, number of TPUTs issued 
47 2F 4 binary Line-in count, number of TGETs satisfied 
5] 33 4 binary Step completion code? 
53 35 1 binary Step dispatching priority 
54 36 8 EBCDIC ‘Terminal Monitor Program (TMP) name 
62 3E 8 EBCDIC Step name (Procedure) 
70 46 2 binary Size of region (in 1K blocks) 
72 48 2 binary Reserved 
74 4A 2 binary Main storage used (in 1K blocks) 
76 4C 6 binary Reserved 
82 §2 1 binary Storage protect key (See TCBPKF, the 


protection key field in the TCB, OS/VS2 
System Data Areas, SY28-0606.) 
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Decimal Hexadecimal 


Displacement Displacement Size 


83 53 1 
84 54 2 
86 56 4 
90 5A 4 
94 5E 6 
100 64 
102 66 7) 


For each device, there is an eight-byte 


1 


After the device entries are the following fields: 


Accounting Section: 


l 


Relocate Section: 
+06 
+4 
+8 
+12 
+16 


& Sf S HS SE 


Field Data 
Format 


binary 


binary 
binary 


binary 


binary 
binary 


binary 


Contents 


Step termination indicators 
Bit Meaning When Set 


0 Reserved 

1 Reserved 

2 Canceled by IEFUJI3 

3 Canceled by IEFUSI3 

4 Reserved 

5 Reserved 

6 0—Normal completion 
1—ABEND 

7 Step not executed (that is, step was 
flushed) 

Reserved 


Device allocation start time of day, in 
hundredths of a second 


Problem program load time of day, in 
hundredths of a second 


Reserved 


Offset from beginning of the record header 
to the relocate section 

Length of device entry portion, including 
this field, which is calculated: (8 x d) + 2, 
where d=number of devices 


entry with the following format: 


binary 
binary 


binary 
binary 


binary 


binary 
binary 


binary 
binary 
binary 
binary 
binary 


Device class from UCBTYP field of unit 
control block 


Unit type from UCBTYP field of unit control 
block 


Channel/unit address 
EXCP count 


Total length of next three fields: step CPU 
time, number of accounting fields, and the 
accounting fields 


Step CPU time, in hundredths of a second4 
Number of accounting fields 
Accounting fields 


Number of page-ins 

Number of page-outs 

Number of swaps 

Number of TSO swap page-ins 
Number of TSO swap page-outs 
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The main storage occupancy time may be invalid if the terminal monitor program supplied by 
IBM is not used. (Refer to OS/VS2 TSO Guide to Writing a Terminal Monitor Program or 
a Command Processor, GC28-0648.) 


The contents of the completion code field varies according to the condition of termination, as 
follows: 


X‘Occe’, which indicates system ABEND; ccc is the ABEND code (see OS/VS Message 
Library: VS2 System Codes, GC38-1008). 

X‘8ccc’, which indicates user ABEND; ccc is the user ABEND code. 

X‘nnnn’, which indicates normal completion; nnnn is the contents of the two low-order bytes 
in register 15 at termination. 

X‘0000’, which indicates either (1) that the job step was not executed (it was flushed) 
because of an error during allocation or (2) a return code of 0 indicating normal 
job completion. To distinguish between a job step flush and to distinguish between 
a system ABEND and a user ABEND, see the step termination indicator field. 


Abnormal or normal termination can be determined from the job-termination indicator 
starting at byte 62 of record type 35. 


Job steps canceled by IEFUJI, or IEFUSI will not be executed; therefore, bit 7 will also be 
turned on. 


CPU time is not expected to be constant between different runs of the same step. One or more 
of the following factors may cause small variations in CPU time: channel program retries, CPU 
architecture (such as core buffering), cycle stealing with integrated channels, queue searching, 
(such as task switching), and pending interruptions. 


Each entry in an accounting field contains the length of the field (one byte, binary) followed 
by accounting information (EBCDIC). An omitted field is represented by a length indicator of 
0. 


The displacement of this field is variable depending on the number of accounting fields. The 
value contained in the field at displacement 100 is the displacement of this field. 
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Record Type 35—LOGOFF 


Record type 35 (VS2 only) is written each time a LOGOFF process has been 
completed. The length is 117 bytes plus the length of each job accounting field. 


Record Type 35 


This record contains the record type, time stamp (time and date), CPU 
identification, number of TGETs satisfied and TPUTs, storage protect key, session 
termination status, LOGON priority, logon sequence time, termination indicator, 
SYSOUT classes for session, and session CPU time. 


The format is: 


Decimal 


0 


10 
12 


22 


26 


30 
38 
39 
43 
47 
51 
53 
54 


58 


62 


Hexadecimal 
Displacement Displacement Size 


0 


nn — 


nm > 


1 


- FF 


hah ON N 


> 


her NHN SF S&S LH — 


Field Data 


Format 


binary 


binary 
binary 
packed 


EBCDIC 
EBCDIC 
EBCDIC 
binary 


packed 


EBCDIC 
binary 
binary 
binary 
binary 
binary 
binary 
binary 


packed 


binary 


Contents 


System indicator 

Bit Meaning When Set 
6 VS2 

Record type 

Time of LOGOFF 


Date of LOGOFF, in the form 00YYDDDF, 
where F is the sign 


System identification 
System model identifier 
User identification field 


LOGON time of day in hundredths of a 
second 


LOGON date, in the form 00YYDDDF, where 
F is the sign 


Reserved 

Number of steps in session 

Reserved 

Line-out count, number of TPUTs issued 
Line-in count, number of TGETs satisfied 
Job completion code! 

LOGON priority 


LOGON enqueue time of day in hundredths 
of a second 


LOGON date, in the form 00YYDDDF, where 
F is the sign 


Termination indicators 
Bit Meaning When Set 


0 Reserved 
1 Reserved 
2 Canceled at exit IEFUJI 
3 Canceled at exit IEFUSI 
4 Reserved 
5 Reserved 
6 0Q—Normal completion 
1—ABEND 
7 Reserved 
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Decimal Hexadecimal Field Data 
Displacement Displacement Size Format Contents 


63 3F 5 binary SYSOUT classes for session? (See record type 
5 for explanation of field.) 

68 44 4 binary Reserved 

72 48 | binary Storage protect key (xxxx0000, where xxxx is 


the key which is described under TCBPKF in 
OS/VS2 System Data Areas, SY28-0606) 


73 49 19 binary Reserved 

92 5C 1 binary Length of rest of record not including this 
field 

93 5D 20 EBCDIC Reserved 

113 71 3 binary Session CPU time, in hundredths of a 
second3 

116 74 | binary Number of accounting fields 

117 75 Accounting fields‘ 


The contents of the completion code field varies according to the condition of the condition 
of termination, as follows: 


X‘Occe’, which indicates system ABEND; ccc is the system ABEND code (see OS/VS Message 
Library: VS2 System Codes , GC38-1008). 

X‘8ccc’, which indicates user ABEND; ccc is the user ABEND code. 

X‘nnnn’, which indicates normal completion; nnnn is the contents of the two low-order types 
in register 15 at termination. 

X‘0000’, which indicates a return code that indicates normal job completion. 


Job termination indicators are provided at byte 62 of this record. For more detailed 
information on job step termination examine record type 34. 
Each bit of the indicator represents the following classes: 


Byte 0 Byte ! Byte 2 Byte 3 Byte 4 
Bir-Class_ Bit-Class Bit—Class Bit-—Class Bit—Class 


0-A 0-I 0-Q 0-Y 0-6 
1-B 1-J I-R 1-Z 1-7 
2-C 2-K 2-S 2-0 2-8 
3-D 3-L 3-T 3-1 3-9 
4-F 4-M 4-U 4-2 
5S—-F 5—N 5-V 5-3 
6-—G 6—O 6—W 6—4 
7-H 7-P 7-X 7-5 


CPU time is not expected to be constant between different runs of the same job. One or more 
of the following factors may cause small variations in CPU time: channel program retries, CPU 
architecture (such as core buffering), cycle stealing with integrated channels, queue searching, 
(such as task switching), and pending interruptions. 

Each entry in an accounting field contains the length of the field (one byte, binary) followed 

by accounting information (EBCDIC). An omitted field is represented by a length indicator of 

0. 
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Record Type 40 


Record Type 40—Dynamic DD 


Record type 40 (vS2 only) is written when the dynamic allocation function 
processes a de-allocation, concatenation, or de-concatenation request. The length 
is 62 bytes plus 8 bytes for each device entry. 


This record contains the record type, time stamp (time and date), CPU 
identification, LOGON time, dynamic allocation function indicators, and a data set 
entry. Each data set entry consists of the device class, unit type, channel/unit 
address, and EXCP count. The data set entry is zeros when the DD entry is TERM, 
DUMMY, or DYNAM. 


The format is: 


Decimal Hexadecimal Field Data 
Displacement Displacement Size Format Contents 


0 0 | binary System indicator 
Bit Meaning When Set 
6 VS2 
1 1 | binary Record type 
2 2 4 binary Time, in hundredths of a second, that record 


was moved to SMF buffer 


6 6 4 packed Date record was moved to SMF buffer, in 
the form 00YYDDDF, where F is the sign 


10 A 2 EBCDIC System identification 
12 G 2 EBCDIC System model identifier 
14 E 8 EBCDIC User identification field 
22 16 4 binary LOGON time of day in hundredths of a 
second 
26 1A 4 packed Logon date, in the form 00YYDDDF, where F 
is the sign 
30 1E 8 EBCDIC Reserved for user 
38 26 1 binary Step sequence number 
39 27 1 binary Functional indicators 
02—De-allocate 
03—Concatenate. 
04—-De-concatenate 
40 28 20 binary Reserved 
60 3C 2 binary Length of rest of record including this field 
For each device, there is an eight-byte entry with the following format: 
| binary Device class from UCBTYP field of unit 
control block 
1 binary Unit type from UCBTYP field of unit control 
block 
2 binary Channel/unit address 
4 binary EXCP count 
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Data Set Activity Records 


C 


Data set activity records describe the characteristics, activity, and user of data sets. 
The following record types, which constitute the group of data set activity records, 
are described in this chapter: 


e Record type 14—INPUT or RDBACK Data Set Activity. 

e Record type 15—-OUTPUT, UPDAT, INOUT, or OUTIN Data Set Activity. 
« Record type 17—Scratch Data Set Status. 

e Record type 18—Rename Data Set Status. 

e Record type 20—Job Commencement. 

¢« Record type 62—VSAM Cluster or Component Opened 

e Record type 64—VSAM Component Status 

e« Record type 68—VSAM Entry Renamed 


Fields in these records marked ‘‘Reserved”’ are reserved for use by SMF and are 
not available for your use. 
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Record Type 14 


Record Type 14—INPUT or RDBACK Data Set Activity 


Record type 14 is written whenever a data set that is defined by a DD statement 
and opened for INPUT or RDBACK processing by a user program is closed or 
processed by EOV. Record type 14 is not written for a data set defined by a DD * 
or DD DATA statement or a SYSOUT data set. For accounting purposes, the card 
image count for these data sets is provided in record type 4. The length varies 
from 288 to 6,412 bytes, depending upon the number of volumes for the data set. 


This record contains the device type, EXCP count, data set indicator, data set 
organization, record format, record length, number of volumes, volume serial 
numbers, and additional information that depends on whether the data set is on a 
tape unit or a direct access device and that depends on the access method used. 


The format is: 


Decimal Hexadecimal Field Data 
Displacement Displacement Size Format Contents 


0 0 | binary System indicator 
Bit Meaning When Set 
6 VS2 
7 VS1 
1 1 | binary Record type 
2 2 4 binary Time, in hundredths of a second, record was 


moved to SMF buffer 


6 6 4 packed Date record was moved to SMF buffer, in 
the form 00YYDDDF, where F is the sign 


10 A Zz EBCDIC System identification 
12 C 2 EBCDIC System model identifier 
14 E 8 EBCDIC Job name! 
22 16 4 binary Time, in hundredths of a second, that the 
reader recognized the JOB card for this job! 
26 1A 4 packed Date that the reader recognized the JOB card 
for this job! 
30 1E 8 EBCDIC User identification field from common exit 
parameter area 
38 26 2 binary Record indicators 
Bit Meaning When Set 
0 Reserved 
] Record written by EOV 
2 DASD device 
3 Temporary data set 
4 DCBDSORG=DA 
5 DCBDSORG=IS 
6 JFCDSORG=IS 
7-15. Reserved 
40 28 4 binary Segment sizes 
Byte Contents 
0 Size of DCB/DEB segment 
1 Number of UCB segments? 
2 Size of each UCB segment 
3 Size of extension segment 
44 20 4 binary Reserved 
48 30 16 TIOT3 segment—a portion of the TIOT, 
including: 
Byte Contents 
0 TIOELNGH 
1 TIOESTTA 
2 TIOEWTCT 
3 TIOELINK 
4 TIOEDDNM 
12 TIOEJFCB 
15 TIOESTTC 
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Decimal Hexadecimal 
Displacement Displacement Size 


64 40 176 
240 FO 24 
264 108 24 

28 


Field Data 


Format 


Contents 


JFCB? segment—the JFCB, excluding JFCB 
extensions 


DCB/DEB? segment 


Byte Contents 

0 DCBDSORG 
2 DCBRECEM 
3 DCBMACRE 
5 DCBOFLGS 
6 DCBOPTCD 
7 Reserved 

8 DEBOFLGS 
9 DEBOPATB 
10 DEBVOLSQ 
(Tape extension) 
12 DCBBLKCT 
16 Data set serial number 


pip Reserved 
(DASD extension) 


12 Reserved (may be non-zero) 

16 Numiber of tracks released by the 
DADSM routine 

20 Number of extents released by the 
DADSM routine 

21 Reserved 


UCB3 segment (24 bytes for each UCB in the 
data set) 


Bytes Contents 

0 UCBCHA 

1 UCBUA 

2 UCBVOLI 

8 UCBTYP 

12 UCBSTAB 

13 Number of extents 

14 Reserved 

16 EXCP count by problem program? 

(Tape extension) 

20 UCBFSCT 

22 UCBFSEQ 

(DASD extension) 

20 Total number of tracks allocated on 
the device 


ISAM Extension for DCBDSORG=«IS 


Byte Contents 

0 Reserved 

2 DCBMAC 

3 DCBNLEV 

4 DCBRORG3 

8 DCBNREC 

12 DCBRORG2 

14 DCBNOREC 

16 DCBRORGI1 

18 Reserved 

19 DEBNIEE 

20 DEBNPEE 

21 DEBNOEE 

22 Number of cylinders in Independent 
Index Area 

24 Number of cylinders in Prime Area 

26 Number of cylinders in Independent 
OVFL Area 
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The job name and the time and date that the reader recognized the JOB card for this job 
constitute the job log number. 


For ISAM data sets, the number of UCB segments in the order stated is one for the index 
extent, one per volume for primary extents, and one for the overflow extent. 


For BPAM concatenated data sets used as input, there is one UCB segment for each data set in 
the concatenated data set. 


For further information about the contents of the TIOT, JECB, DCB, DEB, and UCB, refer to 
OS/VS1 System Data Areas, SY28-0605, and OS/VS2 System Data Areas, SY28-0606. 


The EXCP count accumulates over the entire step. Therefore, if a data set is opened and 
closed twice during a single step, the count in the second record is the sum of all ExcPs for 
both uses of the data set. The EXCP count in the last type 14 record for the step is equal to 
the corresponding entry for the data set in the type 4 record. 
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Record Type 15 


Record Type 15—OUTPUT, UPDAT, INOUT, or OUTIN Data 
Set Activity 


Record type 15 is written whenever a data set that has been defined by a DD 
statement and opened for OUTPUT, UPDAT, INOUT, or OUTIN processing by a user 
program is closed or processed by EOV. The length varies from 288 to 6,412 
bytes, depending upon the number of volumes for the data set. Record type 15 is 
not written for data sets defined as SYSOUT data sets on DD statements. For 
accounting purposes, the SYSOUT logical record count is included in record type 6. 


This record contains the device type, EXCP count, data set indicator, data set 
organization, record format, record length, number of volumes, volume serial 
numbers, and additional information that depends on whether the data set is on a 
tape unit or a direct access device and that depends on the access method used. 


The format is: 


Decimal Hexadecimal Field Data 
Displacement Displacement Size Format Contents 


0 0 1 binary System indicator 
Bit Meaning When Set 


6 VS2 
7 VS1 


1 1 ] binary Record type 


ho 
No 
> 


binary Time, in hundredths of a second, record was 
moved to SMF buffer 


packed Date record was moved to SMF buffer, in 
the form 00YYDDDF, where F is the sign 


A 2 EBCDIC System identification 
12 C 2 EBCDIC System model identifier 
E 8 
4 


ON 
ON 
_ 


EBCDIC Job name! 


binary Time, in hundredths of a second, that the 
reader recognized the JOB card for this job! 


26 1A 4 packed Date that the reader recognized the JOB card 
for this job! 


30 IE 8 EBCDIC User identification field from common exit 
parameter area 


38 26 2 binary Record indicators 
Bit Meaning When Set 


Reserved 
Record written by EOV 
DASD device 
Temporary data set 
DCBDSORG=DA 
DCBDSORGSIS 
JFCDSORG=IS 

-15 Reserved 


40 28 4 binary Segment sizes 
Byte Contents 


0 Size of DCB/DEB segment 
1 Number of UCB segments? 
Z Size of each UCB segment 
3 Size of extension segment 


44 2C 4 binary Reserved 


WAAu PWN © 
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Decimal Hexadecimal Field Data 
Displacement Displacement Size Format 


48 30 16 
64 40 176 
240 FO 24 
240 FO 24 
264 108 24 
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Contents 


TIOT3 segment—a portion of the TIOT, 
including: 
Byte Contents 


0 TIOELNGH 
1 TIOESTTA 
z TIOEWTCT 
3 TIOELINK 
4 TIOEDDNM 
12 TIOEJFCB 
15 TIOESTTC 


JFCB? segment—the JFCB, excluding JFCB 
extensions 


DCB/DEB? segment 
Contents 


DCBDSORG 
DCBRECFM 
DCBMACRF 
DCBOFLGS 
DCBOPTCD 
Reserved 
DEBOFLGS 
DEBOPATB 
0 DEBVOLSOQ 


(Tape extension) 


12 DCBBLKCT 


16 Data set serial number 
22 Reserved 


DCB/DEB? segment 
(DASD extension) 


12 Relative track (TTR) of the last 
record processed for a physical 
sequential data set (left order three 
bytes followed by a byte of zeros). 
The value of this field is valid only 
for writing physical sequential data 
sets.5 This field contains zeros for all 
data set organizations other than 
physical sequential. 


4 
% 


m= OC~ TIA Ui wn © 


16 Number of tracks released by the 
DADSM routine 

20 Number of extents released by the 
DADSM routine 

21 Reserved 


UCB? segment (24 bytes for each UCB in the 
data set) 


Byte Contents 


0 UCBCHA 

1 UCBUA 

2 UCBVOLI 

8 UCBTYP 

12 UCBSTAB 

13 Number of extents 

14 Reserved 

16 EXCP count by problem program* 

(Tape extension) 

20 UCBFCST 

22 UCBFSEQ 

(DASD extension) 

20 Total number of tracks allocated on 
the device 


Decimal Hexadecimal Field Data 
Displacement Displacement Size Format Contents 


28 ISAM extension for DCBDSORG=IS 

Byte Contents 
Reserved 

2 DCBMAC 

3 DCBNLEV 

4 DCBRORG3 

8 DCBNREC 

12 DCBRORG2 

14 DCBNOREC 

16 DCBRORGI 

18 Reserved 

19 DEBNIEE 

20 DEBNPEE 

21 DEBNOEE 

22 Number of cylinders in Independent 
Index Area 

24 Number of cylinders in Prime Area 

26 Number of cylinders in Independent 
OVFL Area 


1 The job name and the time and date that the reader recognized the JOB card for this job 
constitute the job log number. 


2 For ISAM data sets, the number of UCB segments in the order stated is one for the index 
extent, one per volume for primary extents, and one for the overflow extent. 

3 For further information about the contents of the TIOT, JFCB, DCB, DEB, and UCB, refer to 
OS/VS1I System Data Areas, SY28-0605, and OS/VS2 System Data Areas, SY28-0606. 

4 The EXCP count accumulates over the entire step. Therefore, if a data set is opened and 
closed twice during a single step, the count in the second record is the sum of all EXCPs for 
both uses of the data set. The EXCP count in the last type 15 record for the step is equal to 
the corresponding entry for the data set in the type 4 record. 


5 These conditions can be determined by interrogation bytes 0 and 3 of the DCB/DEB segment. 
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Record Type 17—Scratch Data Set Status 


Record type 17 is written whenever a user data set is scratched. (A user’s data set 
is one defined by a user’s DD statement either explicitly or implicitly. When a 
user’s DD statement defines a volume, all data sets on that volume are implicitly 
defined.) The REC parameter determines whether record type 17 is created for 
only non-temporary data sets or for both temporary and non-temporary data sets. 
The length is 88 bytes plus 8 bytes for each volume. The length varies from 96 to 


2,136 bytes. 


This record contains the data set name, number of volumes, and volume serial 


numbers. 
The format is: 


Decimal 


0 


26 
30 


38 
40 
84 
87 
88 


Hexadecimal 
Displacement Displacement Size 


0 


oO N= 


na > 


1A 


1E 


26 
28 
54 
57 
58 


] 


Field Data 


Format 


binary 


binary 
binary 


packed 


EBCDIC 
EBCDIC 
EBCDIC 
binary 


packed 
EBCDIC 


binary 
EBCDIC 
binary 
binary 


Contents 


System indicator 


Bit Meaning When Set 
6 VS2 
7 vSsi 


Record type 


Time, in hundredths of a second, record was 
moved to SMF buffer 


Date record was moved to SMF buffer in the 
form 00YYDDDF, where F is the sign 


System identification 
System model identifier 
Job name! 


Time, in hundredths of a second, that the 
reader recognized the JOB card for this job! 


Date that the reader recognized the JOB card 
for this job! 


User identification field from common exit 
parameter area 


Reserved 

Data set name 
Reserved 

Number of volumes 


Volume serial number (eight bytes for each 
volume) 


Byte Contents 
0-1 Reserved 
2-7 Volume serial number (EBCDIC) 


1 The job name and the time and date that the reader recognized the JOB card for this job 


constitute the job log number. 
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Record Type 18 


Record Type 18—Rename Data Set Status 


Record type 18 is written whenever any data set is renamed. The length is 132 
bytes plus 8 bytes for each volume. The length varies from 140 to 2,180 bytes, 
depending upon the number of volumes for the data set. 


This record contains the old data set name, new data set name, number of 
volumes, and volume serial numbers. 


The format is: 


Decimal 


0 


26 
30 


38 
40 
84 
128 
131 
132 


Hexadecimal 
Displacement Displacement Size 


0 


No — 


oN 


ama > 


IE 


26 
28 
54 
80 
83 
84 


I 


44 
44 


Field Data 


Format 


binary 


binary 
binary 


packed 


EBCDIC 
EBCDIC 
EBCDIC 
binary 


packed 
EBCDIC 


binary 
EBCDIC 
EBCDIC 
binary 
binary 


Contents 


System indicator 
Bit Meaning When Set 


6 VS2 
7 vSs1 


Record type 


Time, in hundredths of a second, record was 
moved to SMF buffer 


Date record was moved to SMF buffer, in 
the form 00YYDDDF, where F is the sign 


System identification 
System model identifier 
Job name! 


Time, in hundredths of a-:second, that the 
reader recognized the JOB card for this job! 


Date that the reader recognized the JOB card 
for this job! 


User identification field from common exit 
parameter area 


Reserved 

Old data set name 

New data set name 

Reserved 

Number of volumes 

Volume serial number (eight bytes for each 
volume) 

Byte Contents 


0-1 Reserved . 
2-7 Volume serial number (EBCDIC) 


1 The job name and the time and date that the reader recognized the JOB card for this job 


constitute the job log number. 
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Record Type 20—Job Commencement 


Record type 20 is written at job initiation when data set accounting and/or direct 
access volume information is specified. In VS1, if a job is canceled at IEFUJV or 
IEFUJI, this record is not written. In VS2, if a job is canceled at IEFUJI, this record 
is not written. The length is 61 bytes plus the length of the job accounting fields. 


Note: For a job canceled at IEFUIV in VS1 and IEFUJV in VS2 no records for the 
job are written. 


This record contains the record type, time stamp (time and date), CPU 
identification, job log number (job name, entry time, and entry date), 
programmer’s name, user identification, number of accounting fields on the Jos 
statement, and accounting fields. 


The format is: 


Decimal Hexadecimal Field Data 
Displacement Displacement Size Format Contents 


0 0 1 binary System indicator 
Bit Meaning When Set 
6 VS2 
7 VvS1 
1 1 1 binary Record type 
Z 2 4 binary Time, in hundredths of a second, record was 
moved to SMF buffer 
6 6 4 packed Date record was moved to SMF buffer, in 


the form 00YYDDDF, where F is the sign 


10 A Z EBCDIC System identification 

12 C 2 EBCDIC System model identifier 

14 E 8 EBCDIC Job name! 

22 16 4 binary Time, in hundredths of a second, that the 
reader recognized the JOB card for this job! 

26 1A 4 packed Date that the reader recognized the JOB card 
for this job! 

30 1E 8 EBCDIC User identification field from common exit 
parameter area 

38 26 2 binary Reserved 

40 28 20 EBCDIC Programmer’s name 

60 3C 1 binary Number of accounting fields 

61 3D Accounting fields? 


1 The job name and the time and date that the reader recognized the JOB card for this job 
constitute the job log number. 


2 Each entry for an accounting field contains the length of the field (one binary byte), followed 
by the field (EBCDIC). An omitted field is represented by a length indicator of 0. 
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Record Type 62 


Record Type 62—VSAM Ciuster or Component Opened 


Record type 62 is written at the successful or unsuccessful opening of a VSAM 
component or cluster. The length is 138 bytes plus 10 bytes for each volume 


listed. 


Record type 62 identifies the VSAM component or cluster and indicates whether it 
was successfully opened. It names the VSAM catalog in which the component or 
cluster is defined and gives the volume serial number of the volume on which this 
catalog is stored. It gives the volume serial number and device type of the volume 
on which the component or cluster is stored. The job that issued the OPEN macro 
is identified by job log number and user identification. 


The format is: 


Decimal Hexadecimal Field Data 
Displacement Displacement Size Format 
0 0 ] binary 
] | | binary 
2 2 4 binary 
6 6 4 packed 
10 A Z EBCDIC 
12 C 2 EBCDIC 
14 E 8 EBCDIC 
22 16 4 binary 
26 1A 4 packed 
30 1E 8 EBCDIC 
38 26 4 binary 
42 2A 44 EBCDIC 
86 56 6 EBCDIC 
92 5C 44 EBCDIC 
136 88 2 binary 


For each volume, there is a 10-byte entry with 
6 EBCDIC 
4 binary 


Contents 


System indicator 
Bit Meaning When Set 


6 VS2 
7 VS1 


Record type 


Time, in hundredths of a second, record was 
moved to SMF buffer 


Date record was moved to SMF buffer in the 
form 00YYDDDF, where F is the sign 


System identification 
System model identifier 
Job name! 


Time, in hundredths of a second, that reader 
recognized JOB statement for this job! 


Date reader recognized JOB statement for 
this job, in form O0OYYDDDF, where F is the 
sign! 

User identification field from common exit 
parameter area 

Open status indicator 


Bit Meaning When Set 


0 Successful 
l Security violation, that is, invalid 
password 


Name of catalog in which the component or 
cluster is defined 


Volume serial number of the volume 
containing the catalog 


Name of the component or cluster 


Number of online volumes containing the 
component or cluster2 


the following format: 


Volume serial number 
Device type? 


1 The job name and the time and date that the reader recognized the JOB statement for this job 
constitute the job log number. If a system task issued the OPEN macro, the job-name field 
may contain blanks, and the time and date fields contain zeros. 


2 The number of volumes is also the number of pairs of fields in the list of volumes. Each pair 


is 10 bytes long. 


3 This is the UCBTYP field from the unit control block. 
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Record Type 64 


Record Type 64—VSAM Component Status 


Record type 64 is written when a VSAM component or cluster is closed, when it 
becomes necessary to switch to another volume to continue to read or write, and 
when there is no more space available to continue to process. If a cluster is closed, 
one record is written for each component in the cluster. The length is 228 bytes 
plus the length of the list of extents. 


Record type 64 indicates whether the component was closed, another volume was 
switched to, or no additional space was available. It describes the device and 
volume on which the component is stored. It gives statistics about various 
processing events that have occurred since the component was defined, such as the 
number of records in the data component, the number of records that have been 
inserted, and the number of control intervals that have been split. The job is 
identified by job log number and user identification. 


The format is: 


Decimal Hexadecimal 


0 0 

1 l 

2 Z 
6 6 
10 A 
12 C 
14 E 
22 16 
26 1A 
30 1E 
38 26 
39 27 
40 28 
84 54 
128 80 
130 82 
134 86 
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1 


& CON N 


Field Data 
Displacement Displacement Size 


Format 


binary 


binary 
binary 


packed 


EBCDIC 
EBCDIC 
EBCDIC 
binary 


packed 


EBCDIC 


binary 


binary 


EBCDIC 


EBCDIC 
binary 


binary 
binary 


Contents 


System indicator 
Bit Meaning When Set 


6 VS2 
7 VS1 


Record type 


Time, in hundredths of a second, record was 
moved to SMF buffer 


Date record was moved to SMF buffer, in 
the form 00YYDDDF, where F is the sign 


System identification 
System model identifier 
Job name! 


Time, in hundredths of a second, that reader 
recognized JOB card for this job! 


Date that reader recognized JOB card for 
this job, in form 00YYDDDF, where F is the 
sign! 

User identification field from common exit 
parameter area 

Situation indicator 


Bit Meaning When Set 


0 Close 
1 Volume switch 
Z No space available 


Indicator of component being processed 
Bit Meaning When Set 


0 Data component 
1 Index component 


Name of the catalog in which the 
component is defined 


Name of the component 


Number of tracks that were requested but 
could not be allocated 


Current high RBA2 


Length of the extent information in the 
following fields 








Decimal Hexadecimal Field Data 
Displacement Displacement Size Format Contents 


For each extent, there is a 26-byte entry with the following format: 


+0 4 binary Beginning cylinder and track, in the form 
CCHH, where CC is the cylinder number and 
HH is the track number 


+4 4 binary Ending cylinder and track, in the form 
CCHH, where CC is the cylinder number and 
HH is the track number 


+8 6 EBCDIC Volume serial number 
+14 2 binary Channel and unit 
+16 2 binary Spindle identification 
+18 4 binary Unit type3 
+22 4 binary Reserved 
Statistics Section:4 
+0 4 binary Length of statistics section, including this 
field 
4 binary Number of levels in the index 
+8 4 binary Number of extents 
+12 4 binary Number of records in the component 
+16 4 binary Number of records that have been deleted in 
a component 
+20 4 binary Number of records that have been inserted 
in the component 
+24 4 binary Number of records that have been updated 
in the component 
+28 4 binary Number of records that have been retrieved 
from the component 
+32 4 binary Number of unused control intervals in the 
component 
+36 4 binary Number of control intervals that have been 
split in the component 
+40 4 binary Number of control areas that have been split 
in the component 
+44 4 binary Number of EXCPs 
Change from OPEN in Statistics at time of EOV and CLOSE: 
+48 4 binary Change in number of levels in the index 
+52 4 binary Change in number of extents 
+56 4 binary Change in number of records 
+60 4 binary Change in number of records that have been 
deleted in the component 
+64 4 binary Change in number of records that have been 
inserted in the component 
+68 4 binary Change in number of records that have been 
updated in the component 
+72 4 binary Change in number of records that have been 
retrieved from the component 
+76 4 binary Change in number of unused control 
intervals in the component 
+80 4 binary Change in number of control intervals that 
have been split in the component 
+84 4 binary Change in number of control areas that have 
been split in the component 
+88 4 binary Change in number of EXCPs 


1 The job name and the time and date that the reader recognized the JOB statement for this job 
constitute the job log number. If a system task caused this record to be written, the job-name 
field may contain blanks, and the time and date fields contain zeros. 


2 This field is applicable only when the record is written during loading—not for subsequent 
processing. 


3 This is the UCBTyYP field from the unit control block. 


4 All of the fields are present. Inapplicable ones contain zeros. The numbers are cumulative, 
from the time the object was defined. 
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Record Type 68 


110 





Record Type 68—VSAM Entry Renamed 


Record type 68 is written when a VSAM Catalog entry (a cluster, component, 
nonVSAM data set, or catalog) is renamed. The length is 166 bytes. 


Record type 68 identifies the entry defined and gives the old name and the new 
name. The job is identified by job log number and user identification. 


The format is: 


Decimal 


0 


82 
126 


Hexadecimal 
Displacement Displacement Size 


0 


No — 


On 


ama > 


Field Data 


| 


Format 


binary 


binary 
binary 


packed 


EBCDIC 
EBCDIC 
EBCDIC 
binary 


packed 
EBCDIC 
EBCDIC 


EBCDIC 
EBCDIC 


Contents 


System indicator 
Bit Meaning When Set 


6 VS2 
7 VS1 


Record type 


Time, in hundredths of a second, record was 
moved to SMF buffer 


Date record was moved to SMF buffer in the 
form 00YYDDDF, where F is the sign 


System identification 
System model identifier 
Job name! 


Time, in hundredths of a second, that reader 
recognized the JOB card for this job 


Date reader recognized the JOB card for this 
job, in form 00YYDDDF, where F is the sign 


User: identification field from common exit 
parameter area 


Name of the catalog in which the entry is 
defined 


Old name of the entry 
New name of the entry 


1 The job name and the time and date that the reader recognized the JOB statement for this job 
constitute the job log number. 
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Volume Records 


Volume records describe the space available on direct access volumes and certain 
error Statistics for tape volumes (ESV). The following record types, which 
constitute the group of volume records, are described in this chapter: 


¢ Record type 19—Direct Access Volume. 
« Record type 21—ESV. 
| - Record type 69—VSAM Data Space Defined or Deleted 


Fields in these records marked “‘Reserved”’ are reserved for use by SMF and are 
not available for your use. 
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Record Type 19 





Record Type 19—Direct Access Volume 


Record type 19 is written for each direct access device on line at IPL and when a 
HALT EOD command or SWITCH SMF command is processed. Record type 19 is 
also written for a user volume whenever it is demounted. The length is 64 bytes. 


This record contains the volume ‘serial number, VTOC address, owner identification 
number, device type, number of unused alternate tracks, number of unallocated 
cylinders and tracks, number of cylinders and tracks in the largest free extent, 
number of unallocated extents, channel and unit address, and module identification 
for the 2314 and 3330 disk drives. 


Note: Record type 19 is not created for DOS volumes used under the operating 
system. Synchronization of clocks is essential in a shared file environment in order 
to determine the latest status of the shared file. 


The format is: 


Decimal Hexadecimal Field Data 
Displacement Displacement Size Format Contents 


0 0 1 binary System indicator 
Bit Meaning When Set 
6 VS2 
7 vS1 

1 1 1 binary Record type 

2 2 .4 binary Time, in hundredths of a second, record was 
moved to SMF buffer 

6 6 4 packed Date record was moved to SMF buffer in the 
form 0O0OYYDDDF, where F is the sign 

10 A 2 EBCDIC System identification 

12 C 2 EBCDIC System model identifier 

14 E 8 Volume serial number 


Byte Contents 


0,1 Reserved 
2-7 Volume serial number (EBCDIC) 


22 16 10 EBCDIC Owner identification of direct access volume 

32 20 4 binary Device type 

36 24 5 binary VTOC address 

41 29 1 binary DS4VTOCI 

42 2A 2 binary Number of DSCBs 

44 2C 2 binary Number of format 0 DSCBs 

46 2E 2 binary Number of unused alternate tracks 

48 30 2 binary Number of unallocated cylinders 

SO 32 Z binary Number of unallocated tracks 

52 34 2 binary Number of cylinders in the largest free 
extent 

54 36 2 binary Number of tracks in the largest free extent 

56 38 2 binary Number of unallocated extents 

58 3A 2 binary Reserved 

60 3C Z binary Channel and unit address in the form 


X‘Ocuu’ where c is the channel address and 
uu is the unit address 


62 3E 2 binary Module identification or drive number 
indicating physical identity of devices having 
movable address plugs. This field is taken 
from bits 2-7 of sense byte 4 for these 
devices. (Refer to the component 
descriptions of these devices for the meaning 
of sense byte 4.) 
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Record Type 21 


Record Type 21—ESV 


Record type 21 is written by the Error Statistics by Volume (ESV) option when a 
user data set on magnetic tape is closed or processed by End-of-Volume. This 
record is written to the SMF data set only if ESV=SMF is specified in the 
SCHEDULR macro instruction at system generation. The length is 44 bytes. 


This record contains error statistics information about the tape volume which can 
be analyzed, formatted, and printed by IFHSTATR or your own user routine. (See 
“IFHSTATR” in OS/VS Utilities, GC35-0005.) 


The format is: 


Decimal Hexadecimal Field Data 
Displacement Displacement Size Format Contents 


0 0 | binary System indicator 
Bit Meaning When Set 
6 VS2 
7 VS1 
1 1 1 binary Record type 
2 2 4 binary Time, in hundredths of a second, record was 
moved to SMF buffer 
6 6 4 packed Date record was moved to SMF buffer, in 


the form 00YYDDDF, where F is the sign 


10 A 2 EBCDIC System identification 

12 Cc 2 EBCDIC System model identifier 

14 E Z binary Length of rest of record including this field 

16 10 6 EBCDIC Volume serial number 

22 16 2 binary Channel/unit address 

24 18 4 binary UCB type 

28 1C | binary Number of temporary read errors 

29 1D 1 binary Number of temporary write errors 

30 1E Z binary Number of start 1/Os 

32 20 l binary Number of permanent read errors 

33 21 | binary Number of permanent write errors 

34 22 1 binary Number of noise blocks 

35 23 2 binary Number of erase gaps 

37 25 2 binary Number of cleaner actions 

39 27 1 binary Tape density (Format of this field is the 
same as that of DCBDEN, the tape density 
field in the DCB.) 

40 28 2 binary Block size or 0! 

42 2A 2 Reserved 


1 This field is 0 if RECFM in the DCB specifies variable or unblocked records, or if you are 
doing your own EXCP processing. 
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Record Type 69 


Record Type 69—VSAM Data Space Defined or Deleted 


Record type 69 is written when a VSAM data space is defined, extended, or 
deleted. The length is 98 bytes. 


Record type 69 gives the total number of free data space extents and the amount 
of unallocated space on the affected volume after the definition, extension, or 
deletion of the data space. The job is identified by job log number and user 
identification. 


The format is: 


Decimal Hexadecimal Field Data 
Displacement Displacement Size Format Contents 


0 0 | binary System indicator 
Bit Meaning When Set 
6 VS2 
7 VS1 
| | | binary Record type 
2 2 4 binary Time, in hundredths of a second, record was 


moved to SMF buffer 


6 6 4 packed Date record was moved to SMF buffer, in 
the form 00YYDDDF, where F is the sign 

10 A 2 EBCDIC System identification 

12 C 2 EBCDIC System model identifier 

14 E 8 EBCDIC Job name! 

22 16 4 binary Time, in hundredths of a second, that reader 
recognized the JOB card for this job! 

26 1A 4 packed Date reader recognized the JOB card for this 
job, in the form 00YYDDDF, where F is the 
sign! 

30 1E 8 EBCDIC User identification field from common exit 
parameter area 

38 26 2 binary Channel and unit 

40 28 2 binary Spindle identification 

42 2A 2 binary Number of free data space extents on the 
affected volume after the data space is 
defined, extended, or deleted 

44 2C 2 binary Number of unallocated cylinders in all of the 
data spaces on the volume 

46 2E 2 binary Number of unallocated tracks in all of the 
data spaces on the volume in addition to the 
number of free cylinders 

48 30 2 binary Number of cylinders in the largest 


continuous unallocated area in any data 
space on the volume 


50 32 2 binary Number of tracks (in addition to the number 
of free cylinders) in the largest continuous 
unallocated area in any data space on the 


volume 
52 34 44 EBCDIC Name of the catalog in which the data space 
is defined 
96 60 6 EBCDIC Volume serial number of the volume on 


which the data space is allocated 


1 The job name and the time and date that the reader recognized the JOB statement for this job 
constitute the job log number. If this information is not available when this record is to be 
written, the job-name field contains blanks, and the time and date fields contain zeros. 
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System Use Records 


System use records describe the configuration and SMF options in effect, give 
system statistics, and record certain events. The following record types, which 
constitute the group of system use records, are described in this chapter: 


Record type 0—IPL. 

Record type 1—Wait Time. 

Record type 2—Dump Header. 

Record type 3—Dump Trailer. 

Record type 7—Data Lost. 

Record type 8—1/O Configuration. 

Record type 9—-VARY ONLINE. 

Record type 10—Allocation Recovery. 

Record type 11—VARY OFFLINE. 

Record type 12—End-of-Day. 

Record type 13—Dynamic Storage Configuration (VS1 only). 
Record type 30—START TS (VS2 only). 

Record type 31—TIOC Initialization (VS2 only). 
Record type 32—Driver (VS2 only). 

Record type 33—Driver Modify (VS2 only). 
Record type 41—MODIFY TS (VS2 only). 


Record type 42——-Stop TS (VS2 only). 


Fields in these records marked ‘‘Reserved”’ are reserved for use by SMF and are 
not available for your use. 
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Record Type 0 


116 


Record Type 0—IPL 


Record type O is written after every IPL of the system. It includes the virtual and 
real storage size and the SMF options in effect. The length is 31 bytes. 


The format is: 


Decimal Hexadecimal Field Data 
Displacement Displacement Size Format Contents 


0 0 1 binary System indicator 
Bit Meaning When Set 


6 VS2 
7 VSs1 


1 | 1 binary Record type 


2 2 4 binary Time, in hundredths of a second, record was 
moved to SMF buffer 


6 6 4 packed Date record was moved to SMF buffer, in 
the form 00YYDDDF, where F is the sign 


10 A 2 EBCDIC System identification 
12 C 2 EBCDIC System model identifier 


14 E 4 binary Limit in minutes of continuous wait time for 
the job (from value specified on JWT 
parameter) 


18 12 4 binary Number of bytes in SMF buffer from value 
specified in BUF parameter 


22 16 4 binary Number of 1K bytes in virtual storage 
26 1A 1 binary SMF options 
Bit Meaning When Set 


0 System and job data to be collected 
1 System, job, and step data to be 
collected 

Exits requested 

Data set accounting 

Volume accounting 

Reserved 

Temporary data set scratch records 
Reserved 


27 1B 4 binary Number of 1K bytes in feal storage 


“TEA tA RW DO 
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Record Type 1 


Record Type 1—System Statistics 


Record type 1 is written after every IPL of the system and at the first job or job 
step termination following the expiration of a ten-minute interval.! The length is 
34 bytes in VS1; 54 bytes in VS2. 


Elapsed time of day (ordinary CPU-processing time) is divided into ten-minute 
intervals for the purpose of collecting system statistics. A system statistics record is 
written at SMF initialization and contains the CPU wait time and paging statistics 
accumulated during the IPL process. This record marks the beginning of the first 
ten-minute interval. Subsequent system statistics records are written at the first job 
or job step termination following the expiration of a ten-minute interval. Each 
system Statistics record contains the wait time and paging counts accumulated 
during all the ten-minute intervals that expired since the last system statistics 
record was written and the time of day that the last ten-minute interval ended. At 
job and step termination, a check is made to see whether at least one ten-minute 
interval has expired since the last system statistics record was written. Processing 
continues, as follows: 


¢ If a ten-minute interval has expired, a system Statistics record is created, and 
the wait time and paging count accumulated during the expired ten-minute 
interval are moved into the record. 


e If more than one ten-minute interval has expired, the wait time and paging 
counts accumulated during the expired ten-minute intervals since the last system 
Statistics record was created is moved into the record. 


e If a ten-minute interval has not expired, no system statistics record is created. 


Note that the only connection between a job or step and system statistics records 
is that the termination of a job or step causes SMF to check whether at least one 
ten-minute interval has expired. 


Figure 44 shows how wait time is collected. The process is similar for collecting 
system paging statistics. When job/step A terminates, three ten-minute intervals 
have expired. The total wait time collected in these three intervals (783 seconds) is 
moved to a system statistics record. When job/step B terminates, no ten-minute 
interval has expired since the last system statistics record was written; therefore, a 
system statistics record is not written. When job/step C terminates, three intervals 
have expired. The total wait time collected in these intervals (809 seconds) is 
moved to a system statistics record. 


1 If a HALT command or SWITCH command is issued before the completion of a ten-minute 
interval, the wait time collected for that interval is written in a record type 12. If the system 
continues processing, the next record type 1 contains the wait-time accumulated from the 
HALT command or SWITCH command to the expiration of the ten-minute interval. 
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Ten-Minute Intervals! 


Wait Time Interval 30 


Wait Time Collected? in a 
Record Type 1 783 
Job/Step Termination se 


1 Elapsed time is divided into ten-minute intervals by SMF and the wait time is collected in 
seconds for each successive interval. 

Collected by totaling the time found in each wait time interval completed before or at each 
job/step termination. A record type 1 is written when a job/step terminates if a ten-minute 
interval has expired. 


Figure 44. Wait Time Collection 


Ne 


Note: If the stop button is pushed to suspend CPU processing on an IBM 
System/370, (1) timing of the ten-minute interval is suspended, but (2) the 
Time-of-Day clock continues to run. The ten-minute interval is based on 
CPU-processing time, not on the Time-of-Day clock. Therefore, the wait time 
interval reflected by time of day (time stamp) is equal to the normal ten-minute 
CPU-processing interval plus the time that CPU processing was stopped. 


There is a relationship among wait time, elapsed time, job time, and system time, 
as shown in the following formula: 


Elapsed time=Job time+ Wait time+System time 


Elapsed time is the length of the measurement interval. It can be obtained by 
calculating the difference between the time stamp on the first type 1 record and 
the time stamp on the type 12 record written when a HALT command or a 
SWITCH command was processed after all jobs processed during the measurement 
interval have terminated. 


Job time is the total time required by all jobs processed in the interval reflected by 
elapsed time. This value can be obtained by summing the CPU time values from all 
the type 5 records produced during the elapsed time. 


Wait time is the total CPU wait time collected during the interval. This value can 
be obtained by summing the wait time values from the type 12 record written at 
the end of the interval and all but the first type 1 records. 


System time is the total time required to process system tasks. This value can be 
calculated when the three other values are known. 


The time stamp in the header of a system statistics record reflects the time at 
which the record was written, not the expiration time of the last ten-minute 
interval. The expiration time field after the header gives the ending time of the 
interval. 
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The format is: 


Decimal Hexadecimal Field Data 
Displacement Displacement Size Format 
0 0 l binary 
l 1 1 binary 
2 Z 4 binary 
6 6 4 packed 
10 A 2 EBCDIC 
12 C 2 EBCDIC 
14 E 4 binary 
18 12 4 binary 
22 16 4 binary 
26 1A 4 binary 
30 1E 4 binary 


The following fields apply only when VS2 is used. 


34 22 4 binary 
38 26 4 binary 
42 2A 4 binary 
46 ZE 4 binary 
50 32 4 binary 


Contents 


System indicator 


Bit Meaning When Set 
6 VS2 
7 VS1 


Record type 


Time. in hundredths of a second, record was 
moved to SMF buffer 


Date record was moved to SMF buffer in the 
form 00YYDDDF, where F is the sign 


System identification 
System model identifier 


System wait time, in hundredths of a 
second, for ten-minute intervals that have 
expired since the last record type 1 or 12 


Expiration time of the end of the interval 
whose statistics are reported in this record 


Total page-ins for the entire system during 
the interval 


Total page-outs for the entire system during 
the interval 


Total pages reclaimed for the entire system 
during the interval 


Total number of regions swapped 


Accumulated number of pages paged in 
when regions are swapped 


Accumulated number of pages paged out 
when regions are swapped 


Number of regions migrated 


Accumulated number of pages paged out 
when regions are migrated 
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Record Type 2 
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Record Type 2—Dump Header 


Record type 2 is written by the SMF dump program at the beginning of a dump 


data set. The length is 14 bytes. 


This record consists of only the standard record header. It indicates the beginning 
of a dump of the SMF data set from a direct access device to tape. Record type 2 
is written directly to the dump data set by the SMF dump program. 


The format is: 


Decimal Hexadecimal Field Data 
Displacement Displacement Size Format 


0 0 1 binary 

1 l 1 binary 

2 2 4 binary 

6 6 4 packed 
10 A Zz EBCDIC 
tZ C o EBCDIC 
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Contents 


System indicator 
Bit Meaning When Set 


6 VS2 
7 VS1 


Record type 


Time, in hundredths of a second, record was 
written to the dump data set 


Date record was written to the dump data 
set, in the form 00YYDDDF, where F is the 
sign 

System identification 

System model identifier 


Record Type 3—Dump Trailer 


Record Type 3 


Record type 3 is written by the SMF dump program at the end of a dump data set. 


The length is 14 bytes. 


This record consists of only the standard record header. It marks the end of a 
dump of the SMF data set from a direct access device to tape. Record type 3 is 
written directly to the dump data set by the SMF dump program. 


The format is: 


Decimal Hexadecimal Field Data 


Displacement Displacement Size 


0 0 1 
] | 1 
2 pi 4 
6 6 4 
10 A 2 
12 C 2 


Format 


binary 


binary 
binary 


packed 


EBCDIC 
EBCDIC 


Contents 


System indicator 
Bit Meaning When Set 


6 VSs2 
7 VS1 


Record type 


Time, in hundredths of a second, record was 
written to the dump data set 


Date record was written to the dump data 
set, in the form 00YYDDDF, where F is the 
sign 

System identification 

System model identifier 
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Record Type 7 


Record Type 7—Data Lost 


Record type 7 is the first record built when an SMF data set becomes available 
after a period when no SMF data sets were available for recording. Data existing in 
the SMF buffers is written to the newly available SMF data set before record type 
7 is built in a buffer. Consequently, record type 7 is not the first record in the 
data set. The length is 24 bytes. 


This record contains a count of SMF records not written, and the start and end 
times of the period during which no records were written. (The end time is the 
time recorded in the record header.) 


Note: The time stamp of record types 4, 5, 34, and 35 reflects the time of the end 
of the job or job step instead of the time that the record was moved to the buffer. 
Therefore, it is possible for the first record after the record type 7 to have a time 
stamp earlier than that of the type 7. 


The format is: 


Decimal Hexadecimal Field Data 
Displacement Displacement Size Format Contents 


0 0 1 binary System indicator 
Bit Meaning When Set 
6 VS2 
7 VS1 
1 1 1 binary Record type 
2 Z 4 binary Time, in hundredths of a second, record was 
built in SMF buffer 
6 6 4 packed Date record was built in SMF buffer in the 


form 00YYDDDF, where F its the sign 


10 A 2 EBCDIC System identification 

12 C Z EBCDIC System model identifier 

14 E 2 binary Number of SMF records lost 

16 10 4 binary Time, in hundredths of a second, of start of 
data loss 

20 14 4 packed Starting date at which no data set was 


available for recording SMF records, in the 
form 00YYDDDF, where F ts the sign 
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Record Type 8 


Record Type 8—1!/O Configuration 


Record type 8 is written after completion of IPL, following the SET DATE 
command. The length is 16 bytes plus 4 bytes for each device online at IPL. 


This record consists of the standard record header and an entry describing each 
device that is on line at IPL. Devices are identified by device class, unit type, and 


device address. 


The format is: 


Decimal Hexadecimal Field Data 


Displacement Displacement Size 


0 0 1 
1 l 1 
2 2 4 
6 6 4 
10 A 2 
12 C 2 
14 E 2 


For each online device, there is a four-byte entry 


1 


Format 


binary 


binary 
binary 


packed 


EBCDIC 
EBCDIC 
binary 
binary 


binary 


binary 
binary 


Contents 


System indicator 
Bit Meaning When Set 


6 VSs2 
7 VS1 


Record type 


Time, in hundredths of a second, record was 
moved to SMF buffer’ 


Date record was moved to SMF buffer in the 
form 00YYDDDF, where F is the sign 


System identification 
System model identifier 
Length of rest of record including this field 


with the following format: 


Device class from UCBTY?P field of unit 
control block 


Unit type from UCBTY?P field of unit control 
block 


Channel address 
Unit address 
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Record Type 9 


124 


Record Type 9—VARY ONLINE 


Record type 9 is written when a VARY ONLINE command is processed. The length 
is 16 bytes plus 4 bytes for each device entry. 


This record identifies the system resource being added to the configuration. 


The format is: 


Decimal Hexadecimal Field Data 
Displacement Displacement Size Format 


0 0 1 binary 

1 1 1 binary 

Z 2 4 binary 

6 6 4 packed 
10 A 2, EBCDIC 
12 C 2 EBCDIC 
14 E 2 binary 


For each device added, there is a four-byte -entry 


1 binary 
1 binary 
1 binary 
1 binary 
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Contents 


System indicator 
Bit Meaning When Set 


6 Vs2 
7 VS1 


Record type 


Time, in hundredths of a second, record was 
moved to SMF buffer 


Date record was moved to SMF buffer in the 
form 00YYDDDF, where F is the sign 


System identification 

System model identifier 

Length of rest of record including this field 
with the following format: 

Device class from UCBTYP field of unit 
control block 


Unit type from UCBTYP field of unit control 
block 


Channel address 
Unit address 





Record Type 10 


Record Type 10—Allocation Recovery 


Record type 10 is written after successful allocation. The length is 40 bytes plus 4 
bytes for each device entry. 


This record identifies the device brought on line, or otherwise made available, by 
device class, unit type, and device address. The job requiring the allocation is 
identified by job name, reader start time, and the user identification field. The 
record is not produced if the operator cancels the job instead of attempting 
recovery. 


The format is: 


Decimal Hexadecimal Field Data 
Displacement Displacement Size Format Contents 


0 0 1 binary System indicator 
Bit Meaning When Set 
6 VS2 
7 VS1 
1 binary Record type 
Z 2 4 binary Time, in hundredths of a second, record was 
moved to SMF buffer 
6 6 4 packed Date record was moved to SMF buffer, in 


the form 00YYDDDF, where F is the sign 


10 A Z EBCDIC System identification 
12 C 2 EBCDIC System model identifier 
14 E 8 EBCDIC Job name! 
22 16 4 binary Time, in hundredths of a second, that the 
reader recognized the JOB card for this job! 
26 1A 4 packed Date that the reader recognized the JOB card 
for this job! 
30 1E 8 EBCDIC User identification field from common exit 
parameter area 
38 26 Z binary Length of rest of record including this field 
For each device being made available, there is a four-byte entry with the following format: 
1 binary Device class from UCBTYP field of unit 
control block 
l binary Unit type from UCBTYP?P field of unit control 
block 
1 binary Channel address 


1 binary Unit address 


1 The job name and the time and date that the reader recognized the JOB card for this job 
constitute the job log number. If allocation recovery is for a system task, the job name field 
contains blanks and the reader start time and reader start date fields will contain binary 
zeros. 
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Record Type 11 


Record Type 11—VARY OFFLINE 


Record type 11 is written when a VARY OFFLINE command is processed. The 
length is 16 bytes plus 4 bytes for each device entry. 


This record identifies the system resource being removed from the configuration. 


The format is: 


Decimal Hexadecimal 
Displacement Displacement Size 


0 


10 
12 
14 


0 


A 
C 
E 


1 


No 


Field Data 


Format 


binary 


binary 
binary 


packed 


EBCDIC 
EBCDIC 
binary 


Contents 


System indicator 
Bit Meaning When Set 


6 VS2 
7 VS1 


Record type 


Time, in hundredths of a second, record was 
moved to SMF buffer 


Date record was moved to SMF buffer in the 
form 00YYDDDF, where F is the sign 


System identification 
System model identifier 
Length of rest of record including this field 


For each device removed, there is a four-byte entry with the following format: 
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1 


1 


1 


binary 
binary 


binary 
binary 


Device class from UCBTY?P field of unit 
control block 


Unit type from UCBTY?P field of unit control 
block 


Channel address 
Unit address 





Record Type 12—End-of-Day 


Record Type 12 


Record type 12 is written when a HALT command or a SWITCH command is 
processed. The length is 34 bytes in VS1; 54 in VS2. 


This record includes the system wait time and paging statistics accumulated 
between the expiration time recorded in the last systems statistics record (record 
type 1 or 12) and the time a HALT command or a SWITCH command was issued. 


The format is: 


Decimal 


0 


22 


26 


30 


The following fields apply only when VS2 is used: 


34 
38 


42 


46 
50 


Hexadecimal 
Displacement Displacement Size 


0 


bo 


ON 


ma > 


1E 


22 
26 


2A 


2E 
32 


l 


4 
4 


4 


4 
4 


Field Data 


Format 


binary 


binary 
binary 


packed 


EBCDIC 
EBCDIC 
binary 


binary 


binary 
binary 


binary 


binary 
binary 


binary 


binary 
binary 


Contents 


System indicator 
Bit Meaning When Set 


6 VS2 
7 VS1 


Record type 


Time, in hundredths of a second, record was 
moved to SMF buffer 


Date record was moved to SMF buffer, in 
the form 00YYDDDF, where F is the sign 


System identification 
System model identifier 


System wait time, in hundredths of a 
second, since the last record type 1 was 
written! 


Expiration time of the end of the collection 
period whose statistics are reported in this 
record 


Total page-ins for the entire system during 
the interval 


Total page-outs for the entire system during 
the interval 


Total pages reclaimed for the entire system 
during the interval 


Total number of regions swapped 


Accumulated number of pages paged in 
when regions are swapped 


Accumulated number of pages paged out 
when regions are swapped 


Number of regions migrated 


Accumulated number of pages paged out 
when regions migrated 


1 If the system continues running after the HALT command or SWITCH command, the next 
record type | contains the wait time accumulated from the HALT command or SWITCH 
command to the expiration of the next ten-minute interval. 
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Record Type 13 


128 


Record Type 13—Dynamic Storage Configuration 


Record type 13 (VS1 only) is written at IPL and after each DEFINE command is 
processed. It shows the amount of storage assigned to each active problem 
program partition. The length is 16 bytes plus 22 bytes for each partition entry. 


The format is: 


Decimal 


0 


Hexadecimal 
Displacement Displacement Size 


0 


No —_— 


oN 


lO > 


| 


Field Data 
Format 


binary 


binary 
binary 


packed 


EBCDIC 
EBCDIC 
binary 


Contents 


System indicator 

Bit Meaning When Set 
7 vSi1 

Record type 


Time, in hundredths of a second, record was 
moved to SMF buffer 


Date record was moved to SMF buffer, in 
the form 00YYDDDF, where F is the sign 


System identification 
System model identifier 


Number of bytes remaining, including this 
field 


For each active problem program partition, there is a 22-byte entry with the following format: 
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me NO NO — 


binary 
binary 
binary 
binary 
EBCDIC 


Partition number 
Storage in 1K blocks 
Reserved 

Number of job classes 


Job classes specified by EBCDIC letters A-0, 
assigned to this partition. The job classes are 
in their specified order, adjusted right, and 
padded to the left with blanks. 


Record Type 30 


Record Type 30—START TS 


Record type 30 (VS2 only) is written each time the time sharing option is started 
with a START TS command. The length is 106 bytes plus 5 bytes for each TS 
region entry. 


This record contains the record type, time stamp (time and date), CPU 
identification, time sharing initiation procedure name, time sharing task identifier, 
time sharing member name in SYS1.PARMLIB, SMF foreground options, maximum 
number of TS regions, TSC region size, time sharing driver name, number of 
terminals allowed, number of time sharing regions, size of each time sharing 
region, and LSQA size in each time sharing region. 


The format is: 


Decimal Hexadecimal Field Data 
Displacement Displacement Size Format Contents 


0 0 1 binary System indicator 
Bit Meaning When Set 
6 VS2 

1 ] 1 binary Record type 

2 2 4 binary Time, in hundredths of a second, record was 
moved to SMF buffer 

6 6 4 packed Date record was moved to SME buffer, in 


the form 00YYDDDF, where F is the sign 


10 A 2 EBCDIC System identification 
12 C 2 EBCDIC System model identifier 
14 E 8 EBCDIC ‘Time sharing procedure name 
22 16 8 EBCDIC Time sharing task identifier 
30 1E 8 EBCDIC Member name in SYS1.PARMLIB 
38 26 | binary SMF foreground options 
Bit Meaning When Set 
0 System and job data to be collected 
1 System, job, and step data to be 
collected 
2 Exits requested 
3 Data set accounting 
4 Volume accounting 
5 Reserved 
6 Temporary data set scratch records 
7 TSO is active 
39 27 1 binary Maximum number of TS regions 
40 28 2 binary TSC region size (in 2K blocks) 
42 2A 8 EBCDIC Time sharing driver name 
50 32 2 binary Maximum number of TS terminals allowed. 
52 34 26 binary Reserved 
78 4E 4 binary Total auxiliary storage available to TSO (in 
2K blocks) 
82 52 2 binary Total auxiliary storage available to 
background (in 2K blocks) 
84 54 1 binary Percentage of backup in use for TSO user 
regions 
85 55 2 binary Maximum number of TS users allowed 
87 57 1 binary Device class of first swap device 
88 58 1 binary Unit type of first swap device 
89 59 2 binary Channel/unit address of first swap device 
91 5B 1 binary Device class of second swap device 
92 5C ] binary Unit type of second swap device 
93 5D 2 binary Channel/unit address of second swap device 
95 5F 1 binary Device class of third swap device 
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Decimal Hexadecimal Field Data 
Displacement Displacement Size Format Contents 


96 60 1 binary Unit type of third swap device 

97 61 2 binary Channel/unit address of third swap device 

99 63 1 binary Device class of fourth swap device 

100 64 1 binary Unit type of fourth swap device 

101 65 2 binary Channel/unit address of fourth swap device 

103 67 2 binary Length of rest of record including these 
bytes 

105 69 1 binary Number of TS regions 


For each TS region, there is a five-byte entry with the following format: 


| binary Region number 
2 binary LSQA size (in 2K blocks) 
2 binary Region size (in 2K blocks) 
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Record Type 31 


Record Type 31—Initialization 


Record type 31 (VS2 only) is written each time the TIOC initialization routine is 
entered by the time sharing control (TSC) task as the result of a START TS 
command. The length is 54 bytes. 


This record contains the record type, time stamp (time and date), CPU 
identification, total number of time sharing buffers, size of time sharing buffers, 
maximum number of output buffers allowed each terminal before OWAIT (program 
wait for output buffers), and maximum number of input buffers allowed each 
terminal before LWAIT (terminal lockup). It also contains the OWAIT threshold 
(the number of buffers that must be freed in order to be freed from OWAIT), 
RESTART threshold (the number of buffers that must be freed in order to be freed 
from LWAIT), number of buffers reserved on the free queue, number of users that 
constitute slack time, size of one terminal sharing block, and logged-on user 
change. 


The format is: 


Decimal Hexadecimal Field Data 
Displacement Displacement Size Format Contents 


0 0 1 binary System indicator 
Bit Meaning When Set 
6 VS2 

1 1 1 binary Record type 

2 2 4 binary Time, in hundredths of a second, record was 
moved to SMF buffer 

6 6 4 packed Date record was moved to SMF buffer, in 


the form 00YYDDDF, where F is the sign 


10 A 2 EBCDIC System identification 

12 C 2 EBCDIC System model identifier 

14 E Zz binary Total number of buffers 

16 10 ps binary Buffer size 

18 12 2 binary Reserved 

20 14 2 binary Maximum number of output buffers allowed 
per terminal before OWAIT! 

22 16 2 binary Maximum number of input buffers allowed 
per terminal before LWAIT2 

24 18 2 binary OWAIT threshold. The number of buffers 
that must be freed in order to be freed from 
OWAIT. 

26 1A Z binary RESTART threshold. The number of buffers 
that must be freed in order to be freed from 
LWAIT. 

28 1C 2 binary Number of buffers reserved on the free 
queue 

30 1E 2 binary Number of users that constitute slack time 

32 20 1 binary Size of one terminal status block 

33 21 1 binary Logged-on user change (indicates when 


maximum number of output buffers allowed 
per terminal before OWAIT and LWAIT are 
to be recalculated; user specifies this in 
START TS command) 


34 22 20 binary Reserved 


1 OWAIT is the suspension of the program during input/output to the terminal because no 
output buffers are available. 


2 LWAIT is the locking up of the terminal user’s keyboard because he has filled all the input 
buffers available to him. 
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Record Type 32 





Record Type 32—Driver 


Record type 32 (VS2 only) is written each time the driver initialization routine is 
entered by the TSC task as a result of a START TS command. The length is 46 
bytes plus 20 bytes for each subqueue entry. 


This record contains the record type, time stamp (time and date), CPU 
identification, driver control flags, guaranteed background execution percentage, 
wait estimate constant, and region estimate constant. For each subqueue the 
following information is recorded: the region number, number of service cycles to 
be given to the users on the subqueue, amount of storage allowed to users on the 
subqueue, maximum main storage occupancy time allowed to users on the 
subqueue, average service time for users on the subqueue, and the minimum time 
slice to be given to a user on the subqueue. 


The format is: 


Decimal Hexadecimal Field Data 
Displacement Displacement Size Format Contents 


0 0 l binary System indicator 
Bit Meaning When Set 
6 VS2 

1 1 | binary Record type 

2 ps 4 binary Time, in hundredths of a second, record was 
moved to SMF buffer 

6 6 4 packed Date record was moved to SMF buffer, in 
the form 00YYDDDF, where F is the sign 

10 A Z EBCDIC System identification 

12 Cc 2 EBCDIC System model identifier 

14 iE | binary Driver control flags—that specify which 


fields are to be ignored by the driver 
Bit Ignore When Set 


Wait estimate 

Region activity 

Main storage occupancy 

Swap load 

Average queue service time 
Background to foreground ratios 
Scheduling of priority 

Current RQEL 


15 F 1 binary Percentage of CPU time to be given to 
background jobs 


“A traf WN — © 


16 10 4 binary Constant used to determine wait estimate 

20 14 4 binary Constant used to determine region estimate 

24 18 2 binary Length of rest of record not including this 
field 
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Decimal Hexadecimal Field Data 
Displacement Displacement Size Format Contents 


For each subqueue for each region, there is a 20-byte entry with the following format: 


l binary Reserved 

1 binary Region number 

2 binary Number of service cycles to be given to 
subqueue 

2 binary Amount of storage in 2K blocks allowed to 
user on subqueue 

4 i binary Maximum main storage occupancy time, in 
hundredths of a second, allowed to user on 
subqueue 

4 _ binary Average service time, in hundredths of a 


second, for user on subqueue 


4 binary Minimum time slice, in hundredths of a 
second, for user on subqueue 


2 binary Reserved 
The remainder of the record contains the following field: 


20 binary Reserved 
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Record Type 33 


Record Type 33—Driver Modify 





Record type 33 (VS2 only) is written each time the driver modify routine is 
entered as a result of a modify driver command if background keyword is 
specified. The length is 16 bytes. 


This record contains the record type, time stamp (time and date), CPU 
identification, driver control flags, and background execution percentage. 


The format is: 


Decimal Hexadecimal Field Data : 
Displacement Displacement Size Format Contents 
0 0 1 binary System indicator 
Bit Meaning When Set 
6 VS2 
1 l 1 binary Record type 
2 2 4 binary Time, in hundredths of a second, record was 
moved to SMF buffer 
6 6 4 packed Date record was moved to SMF buffer, in 
the form 00YYDDDF, where F is the sign 
10 A Z EBCDIC System identification 
12 C 2 EBCDIC System model identifier 
14 E | binary Driver control flags—that specify which 


fields are to be ignored by the driver 
Bit Ignore When Set 





0 Wait estimate 
1 Region activity 
2 Main storage occupancy 
3 Swap load 
4 Average queue service time 
5 Background to foreground ratios 
6 Scheduling of priority 
7 Current RQEL (Request 
Queue Element List) 
15 F l binary Percentage of CPU time to be given to 
background jobs (specified in MODIFY TS 
command) 
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Record Type 41 


Record Type 41—MODIFY TS 


Record type 41 (VS2 only) is written each time a MODIFY TS command is issued if 
any keywords other than background are specified. The length is 81 bytes plus 5 
bytes for each TS region entry. 


This record contains the record type, time stamp (time and date), CPU 
identification, time sharing initiation procedure name, time sharing task identifier, 
SMF foreground options, and maximum number of terminals allowed. For each 
time sharing region that is modified, there is an entry consisting of the total 
number of regions, region number for each modified region, LSQA in the region, 
and size of the region. 


The format is: 


Decimal Hexadecimal Field Data 
Displacement Displacement Size Format Contents 


0 0 1 binary System indicator 
Bit Meaning When Set 
6 VS2 
1 1 binary Record type 
2 2, 4 binary Time, in hundredths of a second, record was 
moved to SMF buffer 
6 6 4 packed Date record was moved to SMF buffer, in 


the form 00YYDDDF, where F is the sign 


10 A 2 EBCDIC System identification 

12 C 2 EBCDIC System model identifier 

14 E 8 EBCDIC Time sharing initiation procedure name 

22 16 8 EBCDIC Time sharing task identifier 

30 1E 8 binary Reserved 

38 26 | binary SMF foreground options 
Bit Meaning When Set 
0 System and job data to be collected 
1 System, job, and step data to be 

collected 

2 Exits requested 
3 Data set accounting 
4 Volume accounting 
5 Reserved 
6 Temporary data set scratch records 
7 TSO is active 

39 27 l binary Percent of backup in use for TSO user 
regions 

40 28 4 binary Total auxiliary storage available to TSO (in 
2K blocks) 

44 2C 2 binary Total auxiliary storage available to 
background (in 2K blocks) 

46 2E 4 binary Reserved 

50 32 2 binary Maximum number of time sharing users 
allowed 

52 34 26 binary Reserved 

78 4E 2 binary Length of rest of record, including this field 

80 50 | binary Number of regions 


For each time sharing region that has been modified, there is a five-byte entry with the 
following format: 


1 binary Region number 

2 binary LSQA (Logical System Queue Area) in 
region (in 2K blocks) 

2 binary Size of region (in 2K blocks) 
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Record Type 42 


Record Type 42—Stop TS 


Record type 42 (VS2 only) is written by the terminate function of the TSC during 
the termination of time sharing options. It is also written when the TSC abnormally 
terminates one or more time sharing regions and none is restarted. The length is 
50 bytes. 


This record consists of the record type, time stamp (time and date), CPU 
identification, time sharing initiation procedure name, and time sharing task 
identifier. 


The format is: 


Decimal Hexadecimal Field Data 
Displacement Displacement Size Format Contents 


0 0 1 binary System indicator 
Bit Meaning When Set 
6 VS82 

1 1 1 binary Record type 

2 2 4 binary Time, in hundredths of a second, record was 
moved to SMF buffer 

6 6 4 packed Date record was moved to SMF buffer, in 


the form 00YYDDDF, where F is the sign 


10 A 2 EBCDIC System identification 

12 C 2 EBCDIC System model identifier 

14 E 8 EBCDIC ‘Time sharing initiation procedure name 
22, 16 8 EBCDIC Time sharing task identifier 

30 1E 20 binary Reserved 
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C 


Subsystem Records 


Subsystem records describe the activities and events of the subsystems. The record 
number is followed by a letter, such as 43H for HASP, that identifies the 
subsystem with which it is associated. 


The following record types, which constitute the group of subsystem records, are 
described in this chapter: 


Record type 43H—HASP Start 

Record type 45H—HASP Stop 

Record type 47H—SIGNON/Start Line 

Record type 48H—SIGNOFF/Stop Line 

Record type 43R—RTAM Start (VS1 only). 
Record type 44R—RTAM Modify (VS1 only). 
Record type 45R—RTAM Stop (VS1 only). 
Record type 47R—LOGON (VS1 only). 
Record type 48R—-LOGOFF (VS1 only). 
Record type 49R—RTAM Integrity (VS1 only). 


Fields in these records marked ‘‘Reserved’”’ are reserved for use by SMF and are 
not available for your use. 
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Record Type 43H 


138 


Record Type 43H—HASP Start 





Record type 43H is written when the system operator enters a START HASP 


command. The length is 24 bytes. 


This record contains the record type, time stamp (time and date), CPU 
identification, and the HASP options. 


The format is: 


Decimal Hexadecimal 
Displacement Displacement Size 


0 


10 
12 
14 


16 
18 


20 
23 
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0 


Field Data 


Format 


binary 


binary 
binary 


packed 


EBCDIC 
EBCDIC 
binary 


binary 
binary 


binary 
binary 


Contents 


System indicator 

Bit Meaning When Set 
7 vs1 

Record type 


Time, in hundredths of a second, record was 
moved to SMF buffer 


Date record was moved to SMF buffer, in 
the form 00YYDDDF, where F is the sign 


System identification 

System model identifier 

Subsystem identification—X‘0002’ signifies 
HASP 

Reserved 


Length of rest of record, not including this 
field 


Reserved 
HASP options: 
Bit Meaning When Set 


0 Format the spool 

1 Cold start 

2 Request automatic initiator 
3 Replacement card option 

4 List replacement card option 
5 Trace 
6-7 Reserved 








Record Type 45H—HASP Stop 


Record Type 45H 


Record type 45H is written only when the system operator enters a STOP HASP 
command. It is not written at normal or abnormal system termination. The length 


is 20 bytes. 


This record contains the record type, time stamp (time and date), and CPU 


identification. 


The format is: 


Decimal Hexadecimal Field Data 
Displacement Displacement Size Format 
0 0 binary 
1 | binary 
Z 2 binary 
6 6 packed 
10 A EBCDIC 
12 C EBCDIC 
14 E binary 
16 10 binary 
18 12 binary 


Contents 


System indicator 

Bit Meaning When Set 
6 VS2 

Record type 


Time, in hundredths of a second, record was 
moved to SMF buffer 


Date record was moved to SMF buffer, in 
the form 00YYDDDF, where F is the sign 


System identification 
System model identifier 


Subsystem identification—X‘0002’ signifies 
HASP 


Reserved 


Length of rest of record, not including this 
field 
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Record Type 47H 
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| Record Type 47H—SIGNON/Start Line 


Record type 47H is written by HASPRTAM under two conditions: (1) when the 
| system operator enters a Start Line command and (2) when a remote user signs on. 
The length is 22 bytes, plus the length of the identification and message sections. 


This record contains the record type, time stamp (time and date), CPU 
identification, HASP subsystem event, remote name, line name, password, and 


message text. 
The format is: 


Decimal 


0 


10 
12 
14 


16 


Identification Section: 


+0 


+2 
+10 
+18 


Message Section:! 


+0 


+2 


Hexadecimal 
Displacement Displacement Size 


0 


NO — 


ON 


ma > 


Field Data 


Format 


binary 


binary 
binary 


packed 


EBCDIC 
EBCDIC 
binary 


binary 
binary 


binary 


binary 


EBCDIC 
EBCDIC 
EBCDIC 


binary 


EBCDIC 


Contents 


System indicator 
Bit Meaning When Set 


6 VS2 
Record type 


Time, in hundredths of a second, record was 
moved to SMF buffer 


Date record was moved to SMF buffer, in 
the form 00YYDDDF, where F is the sign 


System identification 

System model identifier 

Subsystem identification—X‘0002’ signifies 
HASP 

Reserved 


Length of rest of record, not including this 
field 


HASP SIGNON/Start Line subsystem 
event—X‘0001’ signifies SIGNON and 
X‘0002’ signifies Start Line 


Length of- identification section, including 
this field 


Remote name 
Line name 
Password 


Length of SIGNON message section, 
including this field 


Message text? 


| | If this is a Start Line record, this section will not appear. 
2 If this is a SIGNON record, information from columns 35 through 70 of the SIGNON card 


image is placed in this field. 











Record Type 48H 


| Record Type 48H—SIGNOFF/Stop Line 


Record type 48H is written by HASPRTAM under two conditions: (1) when the 
| system operator enters a Stop Line command and (2) when a remote user signs off. 
The length is 48 bytes. 


This record contains the record type, time stamp (time and date), CPU 
identification, HASP subsystem event, remote name, line name, and password. 


The format is: 


Decimal Hexadecimal Field Data 
Displacement Displacement Size Format Contents 


0 0 1 binary System indicator 
Bit Meaning When Set 
6 VS2 
| 1 | binary Record type 
2 2 4 binary Time, in hundredths of a second, record was 
moved to SMF buffer 
6 6 4 packed Date record was moved to SMF buffer, in 
the form 00YYDDDF, where F is the sign 
10 A 2 EBCDIC System identification 
12 C 2 EBCDIC System model identifier 
14 E 2 binary Subsystem identification—X‘0002’ signifies 
HASP 
16 10 2 binary Reserved 
18 12 2 binary Length of rest of record, not including this 
field 
20 14 pi binary HASP SIGNOFF/Stop Line subsystem 
event—X‘0001’ signifies SIGNOFF and 
X‘0002’ signifies Stop Line 
22 16 2 binary Reserved 
24 18 8 EBCDIC Remote name 
32 20 8 EBCDIC Line name 
40 28 8 EBCDIC Password 


Subsystem Records 141 


Record Type 43R 


Record Type 43R—RTAM Start 


Record type 43R (VS1 only) is written by RTAM during RTAM initialization. The 
length is 42 bytes, plus a six-byte entry for each line created. 


This record contains the record type, time stamp (time and date), CPU 
identification, RTAM start procedure name, maximum number of readers and 
writers supported, number of times to activate, and number of lines to start at this 
time. For each line created, a six-byte entry containing line name and unit address 
is made. 


The format ts: 


Decimal Hexadecimal Field Data 
Displacement Displacement Size Format Contents 


0 0 1 binary System indicator 
Bit Meaning When Set 
7 VS1 
1 1 1 binary Record type 
2 2 4 binary Time, in hundredths of a second, record was 
moved to SMF buffer 
6 6 4 packed Date record was moved to SMF buffer, in 
the form 00YYDDDF, where F is the sign 
10 A 2 EBCDIC System identification 
12 C 2 EBCDIC System model identifier 
14 E Z binary Subsystem identification—X‘0001’ signifies 
RTAM 
16 10 2 binary Reserved 
18 12 2 binary Length of rest of record, not including this 
field 
20 14 8 EBCDIC  RTAM Start procedure name 
28 1C 8 binary Reserved 
36 24 1 binary Maximum number of readers supported 
37 25 I binary Maximum number of writers supported 
38 26 1 binary Number of entries in LINE table 
39 27 l binary Number of line DCTs 
40 28 l binary Number of lines to activate 
4] 29 l binary Number of lines to start at this time 


For each line DCT created, there is a six-byte entry, as follows: 


3 EBCDIC Line name 


3 EBCDIC Unit address, in the form cuu where c is the 
channel and uu is the unit 
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Record Type 44R 


Record Type 44R—RTAM Modify 


Record type 44R (VS1 only) is written by RTAM whenever a MODIFY RTAM 
command is issued. The length is 30 bytes, plus a six-byte entry for each line 
modified. 


This record contains the record type, time stamp (time and date), CPU 
identification, RTAM start procedure name, type of modification (start, stop, or 
restart), and number of lines modified at this time. For each line modified, a 
six-byte entry containing line number and unit address is made. 


The format is: 


Decimal Hexadecimal Field Data 
Displacement Displacement Size Format Contents 


0 0 1 binary System indicator 
Bit Meaning When Set 
7 vs! 

| 1 1 binary Record type 

2 2 4 binary Time, in hundredths of a second, record was 
moved to SMF buffer 

6 6 4 packed Date record was moved to SMF buffer, in 


the form 00YYDDDF, where F is the sign 


10 A 2 EBCDIC System identification 

12 C 2 EBCDIC System model identifier 

14 E 2 binary Subsystem identification—X‘0001’ signifies 
RTAM 

16 10 2 binary Reserved 

18 12 2 binary Length of rest of record, not including this 
field 

20 14 8 EBCDIC RTAM start procedure name 

28 1C l binary MODIFY type 
Value Meaning 
1 Start 
2 Stop 
3 Restart 

29 1D 1 binary Number of lines modified at this time 


For each modified line, there is a six-byte entry, as follows: 


3 EBCDIC Line number 


3 EBCDIC Unit address, in the form cuu where c is the 
channel and uu is the unit 
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Record Type 45R 


144 


Record Type 45R—RTAM Stop 


Record type 45R (VS1 only) is written by RTAM when a STOP RTAM command is 


issued. The length is 30 bytes. 


This record contains the record type, time stamp (time and date), CPU 
identification, RTAM start procedure name, STOP status, and number of lines 
started when the STOP was received. 


The format is: 


Decimal 


0 


16 
18 


20 
28 


29 
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Hexadecimal 
Displacement Displacement Size 


0 


Nn —_ 


ON 


ma > 


Field Data 


Format 


binary 


binary 
binary 


packed 


EBCDIC 
EBCDIC 
binary 


-binary 


binary 


EBCDIC 
binary 


binary 


Contents 


System indicator 

Bit Meaning When Set 
7 VS1 

Record type 


Time, in hundredths of a second, record was 
moved to SMF buffer 


Date record was moved to SMF buffer, in 
the form 00YYDDDF, where F is the sign 


System identification 

System model identifier 

Subsystem identification—X‘0001" signifies 
RTAM 

Reserved 


Length of rest of record, not including this 
field 


RTAM Start procedure name 
STOP begun or ended: 
Value Meaning 


0 Begun 
| Ended 


Number of lines started when STOP was 
received 


Record Type 47R—LOGON 


Record type 47R (VS1 only) is written by RTAM whenever a valid LOGON record 
is received by RTAM. The length is 152 bytes. 


Record Type 47R 


This record contains the record type, time stamp (time and date), CPU 
identification, QID entry, passback area, and LOGON record. 


The format is: 


Decimal 


0 


10 
12 


16 
18 


20 
68 
72 


Hexadecimal 
Displacement Displacement Size 


0 


'@) 


10 
12 


14 
44 
48 


1 


48 


80 


Field Data 


Format 


binary 


binary 
binary 


packed 


EBCDIC 
EBCDIC 
binary 


binary 
binary 


binary 
binary 
EBCDIC 


Contents 


System indicator 

Bit Meaning When Set 
7 VS1 

Record type 


Time, in hundredths of a second, record was 
moved to SMF buffer 


Date record was moved to SMF buffer, in 
form 00YYDDDF, where F is the sign 


System identification 
System model identifier 


Subsystem identification—X‘0001' signifies 
RTAM 


Reserved 


Length of rest of record, not including this 
field 


QID entry 
Passback area—X‘8000 0000’ 
LOGON record 
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Record Type 48R 


146 


Record Type 48R—LOGOFF 


Record type 48R (VS1 only) is written by RTAM whenever a LOGOFF record is 
received by RTAM. The length is 68 bytes. 


This record contains the record type, time stamp (time and date), CPU 
identification, and QID entry. 


The format is: 


Decimal Hexadecimal Field Data 
Displacement Displacement Size Format Contents 


0 0 | binary System indicator 
Bit Meaning When Set 
7 VS1 
1 ] | binary Record type 
z 2 4 binary Time, in hundredths of a second, record was 
moved to SMF buffer 
6 6 4 packed Date record was moved to SMF buffer, in 
form 00YYDDDF, where F is the sign 
10 A 2 EBCDIC System identification 
12 C Z EBCDIC System model identifier 
14 E 2 binary Subsystem identification—X‘0001’ signifies 
RTAM 
16 10 2 binary Reserved 
18 12 2 binary Length of rest of record, not including this 
field 
20 14 48 binary QID entry 
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Record Type 49R 


Record Type 49R—RTAM Integrity 


Record type 49R (VS1 only) is written by RTAM whenever an invalid LOGON 
record is received by RTAM. The length is 152 bytes. 


This record contains the record type, time stamp (time and date), CPU 
identification, QID entry, passback area, and LOGON area. 


The format is: 


Decimal 


0 


10 


14 


16 
18 


20 
68 
72 


Hexadecimal 
Displacement Displacement Size 


0 


rN 


ON 


na > 


14 


48 


l 


48 


80 


Field Data 


Format 


binary 


binary 
binary 


packed 


EBCDIC 
EBCDIC 
binary 


binary 
binary 


binary 
binary 
EBCDIC 


Contents 


System indicator 

Bit Meaning When Set 
7 VS1 

Record type 


Time, in hundredths of a second, record was 
moved to SMF buffer 


Date record was moved to SMF buffer, in 
form 00YYDDDF, where F is the sign 


System identification 
System model identifier 


Subsystem identification—X‘0001’ signifies 
RTAM 


Reserved 


Length of rest of record, not including this 
field 


QID entry 
Passback area—X‘FFOO 0000’ 
LOGON area 


Subsystem Records 147 





148 OS/VS System Management Facilities (SMF) 


Appendix A: Field-to-Record Cross-Reference 


This appendix lists all of the fields in the SMF records in alphabetical order and gives the record type containing 
each field and the displacement of the field within the record. 


Record types 30-35 and 40—42 are available only when you are using SMF in a VS2 system. Record type 26 is 
available only in a VS2 system that includes HASP. Record types 43R-45R and 47R-49R are available only in a 
VS1 system. 


Note: Under the DECIMAL DISPLACEMENT column the following abbreviations will appear: ACCT for accounting 
section, ACT for actuals section, DESC for descriptor section, EVET for events section, IDEN for identification 
section, MSG for message section, and REL for relocate section. These abbreviations indicate the section of the 
record where the field is found. 





Raced Displacement 


Field Name Type | Decimal 


ae 


ACCT 


M7 


ACCT 


117 


Accounting fields 


ho 
—) 
ON 
ww 
0 


od 


4 








Alternate tracks available 


Auxiliary storage available to background 


— 
AS 
On 


WwW 
i) 
oe) 
£ 


BON 
— 


oe) 
Nj ~ 
[TI an 


wW 
=) 
Aa 
A aN 


Auxiliary storage available to TSO 





4 
2 


aN 
i) 


1 
1 
31 


On 
ww 


Channel and unit address 


— b 
—= (NM [NO ium [Nin 


ho 
_" 
rO 
ro 





ve] 
io ¢) 
bho 
ON 


io) 
~] 
ro 
La 


[| current high pes 


Cylinders available (unallocated) 


— 
On 
— 
i) 





aS 
oO 
N |W |o js 


] 
32 
S 113 
64 130 





\o 
CO 


Data set name 








— 
Ay 


240 


DCB/DEB segment 


an 
iS 
Bs 


Device added entry 






© 


Device allocation time 


Device class, unit type, and channel/unit address for swap devices 


Ww | Ww 
oO |} 


Ww | — 

io @) 
mipaA nA TY lm 
Oo DN Nn 1a 
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Displacement 
Decimal 


Record 


Field Name Type 


104 





Device entry 


> 


Device removed entry 


Ww 

BSS 

Pom ON = 
Lan 


to 
tod 
No 
N 


Device type 


Nw 
om 
- 


Driver control flags 


tod 
tod 


DSCBs (total number) 


—, 


DS4VTOCI 


bo 
tad 
La 


> Posh 
ho 
& 


Erase gaps 


Estimated execution time 


N 


6 DESC 


Estimated output DESC 
6 
26 
26 
26 


26 


Estimated punched output DESC 


Execution start date EVET 


Execution start time EVET 


[Estimated output 


Execution stop time 


Execution stop date EVET 


EVET 





Extents available (unallocated) 





FCB identifier 


Form number 


nn 
oo 





Format 0 DSCBs 


Functional indicators 


Generated output records 


~) 
Q 


6 DESC 


HASP assigned job number 


; 43H 3 
26 


HASP subsystem event 





Kho 
ON 


HASP execution selection priority 


HASP logical output device name 


HASP options 
DESC 


No 


ND Nw anlar > lw £ ae ee eos 
ba —_ = Bip Q js nla 


6 
47 
48 


HASP output selection priority DESC 





tm | NO 
oS 


I/O status 


Input route code 26 DESC 





| Indicator of component or cluster being processed 


64 39 * 
sa 
JFCB segment as | 
15 64 4 
Job class 26 DESC 


5 51 


Job completion code 


Un 





od 
\O 


Job initiation time and date 
Job input class 





ay 
~— 


N ww | > - N wo f= —_ —_ aN N nN Ww > Lvs) 


5 
5 
5 


~~] 
bk 
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t 
Roce: J roeary Deter 


Field Name | 


t 
: 





—_ 
pe 





0 14 E 
14 14 
15 14 
Job name zl 
es | w |e 
poo | a | EL 
Job options | 26 | pec | | 


Job termination indicator 





ON 
N 
eS) 
tH 





Length of actuals section 


Length of descriptor section 
Length of events section 
Length of identification section 47H 


43H 


‘ihe 
QO 
=] 


DESC 


EVET 


IDEN 





Length of rest of record 


— 
[ee] 
— 
N 





Limit of continuous wait time for job 


= 


Lines per page 


oN 


IDEN 


Wd 
m7 


iw 
co }N 
= |N 
o 





DESC 


Lad 
BSN 
oN 
~ 


\o 
7.) — 


Line-in count, number of TGETs satisfied 


35 


- 
BSN 
oe 


Line-out count, number of TPUTs issued 


Logged-on user change 
LOGON area 4 


> 
lad 





33 


lad 
7) 


Logon enqueue time 


a 








ad 
wi) 


5 as £ 5 
~ | v=) 
Bey 
~~ 


Logon priority 


in 
lad 


LOGON record 


b 
~ 
v*) 
~ 
N 












ta 
- 
N 
No 


— eS ad wW > No No Ne nN N 


Logon time 


Ww 
La 


~~ N | N 
N | N 


Main storage occupancy time 
Main storage used 


ae 


We 
oO 
Ba No — — 
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Field Name | 


Maximum number of input buffers allowed per terminal before LWAIT 


Maximum number of output buffers allowed per terminal before OWAIT 





Maximum number of readers 





Maximum number of TS regions 


Maximum number of TS terminals allowed 





Maximum number of TS users allowed 





Member name in SYS1.PARMLIB 








Record 
Type 


43R 


iv) ASN Ww ve) ive) 





Message class from job card 








Message text 





Modified time sharing region entry 











MODIFY type 


Module identification or drive number of devices having movable address plugs 


Name of catalog in which component or cluster is defined 





Name of catalog in which component is defined 


Name of component or cluster 





New data set name 





| New name of component or cluster 


Noise blocks 





Number of buffers 








Number of buffers reserved on free queue 


Number of bytes in real storage 
Number of bytes in SMF buffer 


Number of bytes in virtual storage 





Number of cylinders in largest free extent 





| Number of cylinders in the largest continous unallocated area in any data space on the 
volume 





Number of data sets processed by writer for this job 





| Number of data spaces on the affected volume after the data space is defined, extended, or 
deleted 








Number of input cards 


Number of lines modified | 


Number of lines started when STOP received 








| Number of online volumes containing the component or cluster 


26 
47H 

4 
44 


— 


oa) 
ft 


ho 
nN 


WwW |W | N Se ee lee 


44 


. 
LA 


62 


Number of records in DD DATA and DD * read for the job 5 


Number of records written by writer 
Number of regions 


Number of regions swapped 


Number of SMF records lost 
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— 


[Decimal | Hex. 
pon fo | te 


36 


24 


39 zy 

50 32 

30 1E 
MSG 

81 51 





bho 
00 
—_ 
O 


On 
So | N 


CO 1}O [Ts 
& |N 


8 


— 
No 
CO 


— wo wo aS 


ok 


4 
28 


ho 
~ 


ho 
No 


lw 
m 


Ww iiN TN 
& | _A | oO 


— Lm ~] 


Wan 
ho 
ive) 
ON 


aN 
00 


ff 
N | N 


Nw |v 
wo [ro {OQ 


— Ww bar > LA 
a | 


136 


& Ff 
~~ 


wo 
& | | 





Ww 
o 


mix [XY {}4 TX [XN |e NM fw 
NM iN [O | | | 0 >it 








ispl t 
Record Displacemen 


Field Name Type 


Number of steps in job 5 
Number of tracks in addition to the number of free cylinders in the largest continous 
unallocated area in any data space on the volume 

Number of tracks in largest free extent 


| Number of tracks requested but not allocated 64 
Number of TS regions 30 


Number of unallocated tracks in all data spaces on the volume tn addition to the number of 
free cylinders 


Number of users that constitute slack time 


Decimal 


La 17) 
BN 
ww w IN 


aN 
ON 
N 
es 


8 


w,) 
oO 





ee 
Co |N 
tr | CO 





30 1E 
7 87 57 

Number of volumes 
131 83 





Old data set name 
| Old name of component or cluster 


Online I/O device entry 


co | & 
N | oO 
wm | N 
NI | CO 


— 
BS 









ON 
to 
ww 
Co 


| Open status indicator 


Output form number 


Output punched cards generated to spool 


iw 


—_ | Ww 
— 


6 
6 
6 
6 
6 
6 


DESC 


nN 


EVET 


hw 


Output processor start date EVET 


No 


Output processor start time EVET 


tN 


lo 2) 
lo] 





Output processor stop date EVET 


Nw 


Output processor stop time EVET 





Output route code 


OWAIT threshold 
Owner identification of direct access volume 


Page-ins for job step 4 REL 
22 


a2 
— 
NHN | N 
N | 
a an 


84 


Page-ins for system during interval Fe 


22 
[Page-ins for Tso session |e | 
Page-outs for job step 4 | ee | 


| 1 | 26 1A 

Page-outs for system during interval 
[Page-outs for tso session tee] 
1 [ss | 6 
Pages paged in when regions are swapped 
1 [Pe 
P d out wh d 7 
ages paged out when regions are swappe 













Pages paged out when regions are migrated 
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Field Name Type Decimal | Hex. 
pi fo |e 


12 


Pages reclaimed for system during interval 





wd 
—) 


Partition characteristic entry 
| Partition or region size 4 


| 


70 


ON 
[o6) 


47R 
Passback area 


ON 
[o'6) 


alee 





| 
| Password 
40 | 28 
30 


Percent of backup in use for TSO user regions 





Percent of CPU time given to background jobs 


33 
26 
26_|_pesc 
26 | act 
26 | Ac 


Problem program load time 


Program name 
| Programmer's accounting number 26 


Programmer's name 


NO — 
— Lv) 
tn \O 





— 
in 


DESC 





34 
4 


N |N NIN 1A Rift ine je le nN |Y wm | milwn N [wu 


nN 
tT 


54 
| DESC 


93 


bo 
© 


6 
26 
6 
26 


DESC 


Programmer's room number DESC 


NO 


Punch form number DESC 


Punch route code DESC 


i) 
ON 
> 
Q 
— 


Punched cards 


47R 
QID entry 4 


[Read errors (permanent) 
[Read errors (temporary) 
[Reader device classandtype |S 
[Readerstopdate 
Readerstoptime 


4 





es) 
y,°) 

Y {NM 
Oo 1; 


No 
—) 


bo 
a) 


No 


EVET 


EVET 


BAN 
wd 
Oo 


Record indicators 


Record type All 
Records in DD DATA and DD * read for the job step 4 


ry 
Un 
Ww 
Oo 





BSS 
~] 


Regions migrated 


ess 
ON 


On 


foram. 


—" 
NO 
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Displacement 


Record 
Field Name Type | Decimal | Hex. 
47H 
Remote name 
meme 48 


Reserved for your use 


IDEN 





Ww 
i) 


o 

I'S) 

uN 
i 


w |w 
La & 


b w |w |w > DS xs 
alan hia ~A |x | 


Ww 
i) 





© 


Restart threshold 26 


a 


3 


tN 
© 


No 
© 
1 


RTAM Start procedure 








5 


Section indicator 26 


Segment sizes 


Session CPU time 35 


Situation indicator 


v2 
NO 
=) 


— | 
mn | 


113 


ON 
a 
ww 
ioe) 





Size of one terminal status block 


SMF foreground options 


SMF options 
Start 1/Os 21 
Starting date at which no data set was available for recording SMF records 7 


32 








41 


MN [Wilh [| w 
So |oa | oo 


Step completion code 


—) 
Lm | A Ww js 

w | uw — FR In Is fa ly lye [AW ly Ty [YX [= 
w | Ww mir In inl an lo [an |— |o jo iO [a 





34 


4 
Step CPU time 
34 ACCT 


Step dispatching priority 34 53 
Step initiation time and date 4 39 Zi 


4 62 3E 
Step name 
34 


Step priority 4 


3 


26 


ACCT 


wo 
va) 





26 
Step sequence number 


















Step termination indicators 
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i t 
Reeced Displacemen 


Field Name Type | Decimal 


82 





Storage protect key 


wo 
& 
~l 
ho 


oj,“ 
N |N 





Subqueue entry 


; 74 


—= |b ip iw Ww 


35 
4 
32 


ho 
ON 


Ld 


43 
45 
47 
48 


a0 
5 


oh 


to 
cyt | t o 

7 hh | TS 
to 


aN 
eS 
y 
a 


Subsystem identification 






SS eS 
oo j“] [wh 
AA AIA 
BR JS 


w 
* |x 


aS 


ASS 
\O 


Swaps that occurred for session 


a 
tT 





SYSOUT class 


5 

5 
All 
All 
All 
2 
2 

34 


Termination indicators 


3 
1 


& 


an 
a 


ww — — Oo Oo tod 
NO |W [Ww [Pp Ww |W |b 


On 
ho 





Time and date of SYSOUT start 


Time and date reader recognized end of job 


La 
- 


3 


too 
w 
\o 
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ae 





So 
NO 
NO 
—_ 
ON 


— 
NO 
No 
i 
ON 






NO 
i] 
—_ 


LA 
NO 
i] 
— 
ON | OD 


Time and date reader recognized JOB card 


~~] 





DN 1H JN 
- ON 
N |N [NN 
N |N [NN 
Le lO 
NR | Dn TD 


—= | |e 
N ioe) > 

NO 

NO 

—— 

ON 


NO 
— 
ON 


ho 
ON 
—_ 
> 


Time and date record moved to SMF buffer All 


N 





Time of end of collection period 12 


—" 
No 


Time of end of interval 


Time of start of data loss 
Time reader recognized job card 


NO 

S 

No f= [fe jo 
fale ee 
ee | 
Nin jo [rn 


Time record was written to the dump data set 





Time sharing driver name 


BAN 


Ww Lvs) 
ho 
ho 
— 
nN 


BN 


ww 
>) 
> |S i8 
mim |> [x 


Time sharing initiation procedure name 


Time sharing procedure name 





oN 
oOo |N 
— | 
| 
tT 


- 
No 


Time sharing task identifier 16 


BN 
& | N 
fe 
ao |N 
wd | 
oO jn 


TIOT segment 











48 


Tracks available (unallocated) 32 


\O 

ws 

° 
w 

fs 





TS region entry 


© 
—t 
© 
ON 
~~] 
© 





TSO region size 


© 
pa 
© 
No 
io] 





N f=] Ja Jw fw /w lw | — 
re — jun fA - 
_ 
re 


TSO swap page-ins E 


ms 
ive! 
ft 


TSO swap page-outs 





264 108 
UCB segment 

264 108 
UCB type 24 18 
UCS identifier 80 50 
Unit address 44 33 21 
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— 
Field Name Type | Decimal | Hex. 


30 
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i) 
Ln 
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> | Ge 
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nh 
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User-identification field from common exit parameter area 
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User-identification field from QIDLGNID field 
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fo) 
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wW 
No 


Volume serial number 


Volume serial number of volume containing the catalog 


Volume serial number of volume on which data space is allocated 





On 
ho 


we 
ON 


VTOC address 





ww 
tod 


Write errors (permanent) 


Write errors (temporary) 





—_— 
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Index 


Indexes to systems reference library manuals are 


consolidated in OS/VS Master Index, GC28-0602. 
For additional information about any subject listed 
below, refer to other publications listed for the same 


subject in the Master Index. 


Note: If more than one page number is given, the 


primary discussion is listed first. The entries in the 
index appear the same way they appear in the body 
of the book, which means that entries with bold type 
or italic type in the body of the book appear in bold 


type or italic type in the index. 


| 5 
Do oe oars 5 
[ ] 5 
5 
A 
accounting field format 65 
accounting records 
complete ial aa 79 
introduction 14 
allocating space for SMF i data sets 45 
allocating space on direct access devices 45 
allocation recovery record (type 10) : 
complete description 125 
introduction 18 
ALT parameter 39 
alternate SMF data set aatanicie: (ALT) 39 
analysis and report routines . 53 
ASMFCL procedure 74, 55 
assemble and link edit stocedure: 53 
auxiliary storage requirements 46 
SMF data sets 47 
system libraries . 47 
B 
blocking of SMF records 46 
braces > 
brackets 5 
BUF parameter 38 
buffer, SMF 
main storage acai 46 
specifying 38 
buffer size parameter (BUF) . 38 
C 
cataloged procedure, ASMFCL. . . 74,55 
class, SYSOUT . . . : 86 
cluster or component opened secon ape 62) 
complete description 107 
introduction 16 
coding examples (see sariples: 
commands 
HALT : 51,47 
records eeiten une iveuedl. 127,112 
MODIFY RTAM . . . 143 
MODIFY TS . 135 
START TS 129,130 
STOP RTAM 144 
SWITCH ‘ 51,47 
records written ei issued... 127,112 
VARY . 124,126 


common parameter area 60 
communication area . . 58 
compatibility , 26 
between VSi and MFT . 26 
between VS1 and vSs2 27 
between VS2 and MVT............46-. 26 
component status record (type 64) 
complete description 108 
IMCFOCUCHION: 2, sy. ee Qe A hk we Re er es 16 
configuration record, 1/0 (ee: 8) 
complete description 123 
introduction ic Mine Gs he aie SG tae et 18 
conventions, notational — . 4 
CPU model number parameter (MDL) 35 
CTRLPROG macro instruction 33 
QSPACE parameter 33 
SYSQUE parameter 33 
D 
data-collection parameters : 40,13 
data set/direct access volume (psv) a 37 
system/job/step (OPT) 36 
temporary dataset (REC) ............ 37 
data generator utility program (IEBDG) 
used by TESTEXIT 72 
data lost record (type 7) 
complete description Mt 2-2 122 
introduction . 18 
data management eansiderations 46,50 
data sets 
installation defined ............88. 59 
SMF 
allocating direct access space for. . . sa SO 
alternate . 38,39,47 
primary . : . 38,39,47 
resident on dived access 46,50 
temporary 
HDRDATA 53 
SORDATA . . 53 
data set activity records 
complete descriptions . 97 
introduction 14 
data space defined or deleted record type 69) 
complete description e930 4 Ae 4 114 
introduction Sy te 17 
designing a report program . 54 
direct access devices 
determining appropriate extents 47 
specifying extents. .......... 50 
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